Eagle3D is installed from a ZIP package. You upload it to your web space, open your site in a browser and follow the setup wizard. The whole process takes a few minutes.
Before you start
- Check the server requirements.
- Have the Eagle3D installation package (a ZIP file) on your computer. Download it from the link in your licence email.
- Decide on the address you will use, for example
https://print.example.com/. The licence is bound to this domain later, andwwwand non-wwwcount as different domains. - Make sure the domain or subdomain already opens over HTTPS.
- You do not need the licence activation code yet. Eagle3D asks for it after the first sign-in.
Step 1. Create an empty database
- In your hosting panel, open the database tool (for example cPanel > MySQL Databases).
- Create a new database and a database user with a strong password.
- Add the user to the database with ALL PRIVILEGES.
- Note the database name, the user name and the password. You need them in the wizard.
Step 2. Upload the files
Upload the ZIP package to the folder of your site (for example public_html or the folder of a subdomain) and extract it there. In cPanel you can use the File Manager: upload the ZIP, then choose Extract.
If you have SSH access, you can do the same from the command line:
cd ~/print.example.com
unzip ~/eagle3d-installation.zip
Replace the folder and the file name with your own. The package extracts directly into the folder; index.php, order.php and the app, pages and install folders should now be in the site folder.
Step 3. Run the setup wizard
Open your site in a browser, for example https://print.example.com/. The setup wizard (Eagle3D Setup) starts automatically. You can switch the wizard between English and Turkce at the top right.
1. Server
The wizard checks the PHP version, the PHP extensions, the writable folders and HTTPS. Items marked red must be fixed before you can continue; fix them in your hosting panel and click Check again. Items in orange are warnings. When everything required is in place, click Continue.
2. Database
Enter the connection details from step 1:
| Field | What to enter |
|---|---|
| Host | Usually localhost |
| Port | Usually 3306 |
| Database name | The database you created |
| Username | The database user |
| Password | The password of the database user |
Click Test connection and continue. The wizard checks the connection, the database version and that the database is empty.
3. Business & Admin
Enter your business details and the first administrator account. The business details can be changed later in Settings → General; the domain cannot be changed there.
| Field | What it does |
|---|---|
| System / business name | The name shown in the panel, on the order page and in emails |
| Domain | The domain the licence is bound to. Enter the exact address you will use. |
| Application folder | Shown for information: the folder Eagle3D runs in (/ for the root) |
| System language | The language of the panel, the order page and the tracking page (12 languages) |
| Country | Sets the phone number format. For Turkiye, all provinces and districts are preloaded. |
| Currency symbol | 1 to 5 characters, suggested from the country |
| Number format | 1.234,56 or 1,234.56 |
| Time zone | Used for dates, due dates and reports |
| Business type | Individual / small workshop or Company (staff module enabled) |
| Username | 3 to 50 characters: letters, digits, dot, dash and underscore |
| The administrator's email address | |
| Password and Password (repeat) | At least 10 characters; very simple passwords are refused |
Click Start installation. The wizard creates the tables, writes the default values and creates the administrator account. If something fails, the database is rolled back and you can try again.
4. Done
The wizard shows Installation complete and a Security check: it tests whether sensitive files (such as .env) can be opened from outside. Each line should say not reachable from outside. If a line says REACHABLE FROM OUTSIDE, check the server access rules before you go live.
For extra safety you can delete the install folder from the server; the wizard has already closed itself. Click Go to sign in.
Step 4. Sign in and activate the licence
Sign in with the administrator account you just created. Eagle3D then asks for your licence activation code. See Activate your Eagle3D licence.
The settings file .env
The wizard writes a file named .env in the application folder. It contains the database connection, the application folder, the licence domain (APP_DOMAIN) and the application key (APP_KEY).
- Keep a copy of
.envin a safe place. It is not part of the database backups. - Never change
APP_KEY. Saved store keys, the SMTP password and the licence data are encrypted with it. - Never share the file; it contains your database password.
Behind Cloudflare or a reverse proxy
If your site runs behind Cloudflare or another reverse proxy, add a line like this to .env, with your proxy addresses (IP addresses or ranges, separated by commas):
TRUSTED_PROXIES="203.0.113.10, 198.51.100.0/24"
Sign-in and order limits then use the real visitor address. See Security and data ownership.