ARN Smart Support
Language: English

Eagle3D server requirements

Updated 5 Nov 2026 3 min read

Feedback saved.

Browse Eagle3D articles

Eagle3D runs on standard web hosting, including cPanel accounts. Check these requirements before you install it. The setup wizard checks most of them for you in its first step.

Minimum versions

RequirementVersion
PHP8.1 or later. PHP 8.5 is supported.
DatabaseMySQL 5.7 or later, or MariaDB 10.3 or later
HTTPSAn SSL certificate for live use (for example AutoSSL in cPanel)

The setup wizard does not continue with an older PHP or database version.

PHP extensions

ExtensionNeeded forIf it is missing
pdo_mysqlDatabase connectionSetup cannot continue
mbstringText handling in all languagesSetup cannot continue
jsonSettings and data exchangeSetup cannot continue
opensslEncryption of saved keys, secure connectionsSetup cannot continue
curlLicence, updates, store connectionsSetup cannot continue
zlibCompressed backupsSetup cannot continue
zip (ZipArchive)Installing updatesEagle3D works, but updates cannot be installed
gdResizing product imagesProduct images are stored without resizing
sodiumChecking licence signaturesEagle3D uses the fallback that ships with the package

You can usually switch extensions on in your hosting panel (for example under the PHP version or PHP extensions settings).

Database

  • Create an empty database and a database user in your hosting panel (for example cPanel > MySQL Databases).
  • Add the user to the database with ALL PRIVILEGES.
  • Eagle3D installs only into an empty database. If the database already contains tables, the wizard asks you to create a new one.

Folders that must be writable

FolderWhy
The application folderThe wizard writes the settings file .env here
app/storageUpdate packages and other working files
app/storage/logsLog files
app/storage/backupsDatabase backups
uploadsProduct images (created on the first upload)

Web server

  • Eagle3D can be installed in the root of a domain or subdomain (for example https://print.example.com/) or in a subfolder.
  • Access rules are included for Apache (.htaccess) and IIS (web.config). They block the settings file, logs, backups and internal folders.
  • On another web server, block the same files and folders yourself. At the end of setup the wizard shows whether sensitive files can be reached from outside.

Domain and licence

The licence is bound to the domain you enter in the setup wizard. www.print.example.com and print.example.com count as different domains, so decide which address you will use before you install. See Activate your Eagle3D licence.

Outgoing connections

Your server must be able to open HTTPS connections to:

  • the ARN Smart licence and update server (licence checks and updates);
  • your web store, if you connect one (see Connect your web store);
  • your mail server, if you send email through SMTP.

Behind Cloudflare or a reverse proxy

If your site runs behind Cloudflare or another reverse proxy, add the proxy addresses to the .env file as TRUSTED_PROXIES so that sign-in and order limits see the real visitor address. See Security and data ownership.

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