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
| Requirement | Version |
|---|---|
| PHP | 8.1 or later. PHP 8.5 is supported. |
| Database | MySQL 5.7 or later, or MariaDB 10.3 or later |
| HTTPS | An 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
| Extension | Needed for | If it is missing |
|---|---|---|
pdo_mysql | Database connection | Setup cannot continue |
mbstring | Text handling in all languages | Setup cannot continue |
json | Settings and data exchange | Setup cannot continue |
openssl | Encryption of saved keys, secure connections | Setup cannot continue |
curl | Licence, updates, store connections | Setup cannot continue |
zlib | Compressed backups | Setup cannot continue |
zip (ZipArchive) | Installing updates | Eagle3D works, but updates cannot be installed |
gd | Resizing product images | Product images are stored without resizing |
sodium | Checking licence signatures | Eagle3D 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
| Folder | Why |
|---|---|
| The application folder | The wizard writes the settings file .env here |
app/storage | Update packages and other working files |
app/storage/logs | Log files |
app/storage/backups | Database backups |
uploads | Product 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.