ARN Smart Support
Language: English

Install Eagle3D on your server

Updated 5 Nov 2026 5 min read
Browse Eagle3D articles

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, and www and non-www count 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

  1. In your hosting panel, open the database tool (for example cPanel > MySQL Databases).
  2. Create a new database and a database user with a strong password.
  3. Add the user to the database with ALL PRIVILEGES.
  4. 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:

FieldWhat to enter
HostUsually localhost
PortUsually 3306
Database nameThe database you created
UsernameThe database user
PasswordThe 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.

FieldWhat it does
System / business nameThe name shown in the panel, on the order page and in emails
DomainThe domain the licence is bound to. Enter the exact address you will use.
Application folderShown for information: the folder Eagle3D runs in (/ for the root)
System languageThe language of the panel, the order page and the tracking page (12 languages)
CountrySets the phone number format. For Turkiye, all provinces and districts are preloaded.
Currency symbol1 to 5 characters, suggested from the country
Number format1.234,56 or 1,234.56
Time zoneUsed for dates, due dates and reports
Business typeIndividual / small workshop or Company (staff module enabled)
Username3 to 50 characters: letters, digits, dot, dash and underscore
EmailThe 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 .env in 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.

Next steps

On this page

Submit a ticket

Create a new support request without needing a portal account.

Priority
Attachments
Only you and our staff see a ticket. Never send passwords or licence codes.

Track a ticket

Use the ticket number and password from your confirmation email.

The number and the password are in your confirmation email.

Sign in

Access your support portal account.

New here?

Create account

Create your support portal account.

Already have an account?

Forgot password?

We email you a link to choose a new password.

Conversation

Was this helpful?
Open full article
↑ ↓ to moveEnter to openEsc to close