ARN Smart Support
Language: English

Update Eagle3D

Updated 20 Nov 2026 5 min read
Browse Eagle3D articles

New Eagle3D versions are delivered by the ARN Smart update server to installations with an active licence. You install them from the panel with one button. Eagle3D backs up the database and every file it changes before it writes anything.

Where to find it: Settings → Update (administrators). When a new version is available, the sidebar also shows Update available: v… with a link to this screen.

Before you start

  • Make sure the licence is active. See Activate your Eagle3D licence.
  • The PHP zip extension must be installed, and app/storage must be writable. Settings → Update shows a warning if zip is missing.
  • Back up your data. Open Settings → Backup, click Back Up Now and download the file. Also keep a copy of the .env file and the uploads folder; they are not part of the database backup. See Back up and restore your data.
  • Choose a quiet moment. The system is in maintenance mode for a few seconds during the update.

Install an update

  1. Open Settings → Update. Installed version shows your current version.
  2. Click Check for Updates. If a new version exists, Eagle3D shows New version available, the Package size and the Release notes. A mandatory update is marked "This update is marked as mandatory."
  3. Read the release notes, then click Install Update and confirm.
  4. Eagle3D downloads and verifies the package and writes the files ("Downloading and verifying the package, writing files..."), then applies the database steps ("Files written. Applying database steps...").
  5. When the message "Update complete. Installed version: …" appears, the update is finished.

Eagle3D also checks for updates in the background, at most every 12 hours, while an administrator uses the panel.

What the updater does for you

  • It checks the package against its SHA-256 checksum and the signed update information from the ARN Smart server, and stops if they do not match.
  • It backs up the database and every file that will change before installing. If writing a file fails, the files already written are put back from that backup. If the server stops the update while it writes (for example at a time limit), the old files are put back when the update lock ends, after at most 10 minutes.
  • When all files are written, the first request that runs with the new version finishes the database steps, even if the browser never got the answer (for example after a proxy timeout). The page then shows "No reply from the server; checking the result of the update..." and follows the update instead of reporting it as failed.
  • It never touches your settings file (.env), your data or your backups.
  • After the update, the Last update card shows the old and new version, the date, the number of files and the backups taken. Eagle3D reports the new version to the ARN Smart server ("Reported to the ARN server").

If an update step is not finished

If Settings → Update shows "An update step (database) is not finished yet. Press the button to complete it.", click Complete Update. This applies the remaining database steps with the new version.

Installations on an earlier 1.0.x version can update directly to 2.0.0.

If the update fails

MessageWhat to do
An active license is required for updates.Activate or renew the licence first.
The PHP "zip" extension is missing on this server; updates cannot be installed.Enable the zip extension in your hosting panel.
Could not reach the ARN update server.Check that your server can open outgoing HTTPS connections, then try again.
Another update is in progress. Try again in a few minutes.Wait a few minutes; the lock ends by itself.
The package SHA-256 does not match; the file is corrupt or modified. Aborted.Nothing was changed. Try again later; if it repeats, contact support.
A file could not be written; changes were rolled backCheck the file permissions of the application folder.
A file could not be written and these files could not be rolled back: …The site stays in maintenance mode, and Eagle3D tries to put the files back again when the update lock ends. If it does not open again, restore the named files from the backup in app/storage/updates that the message names, or contact support.

Update with an update package

If ARN Smart support gives you an Eagle3D update package (a ZIP file) instead:

  1. Back up as described above.
  2. Extract the package into the application folder and let it replace the existing files. The package does not contain .env, .htaccess, web.config, the install folder or app/storage, so your settings, data and backups stay in place.
  3. Sign in as an administrator and open Settings → Update.
  4. If the screen shows that an update step is not finished, click Complete Update.
  5. Check Installed version and the version in the footer of the panel.

Use the built-in updater whenever you can; it verifies the package and can roll back on its own.

Language files and updates

Updates replace the twelve language files that come with Eagle3D (ar, de, el, en, es, fa, fr, he, it, nl, ru, tr). A language file you added under a new name is not touched; do not give your own file one of these codes, or an update will overwrite it. See Business profile, country, currency and language.

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