Skip to main content
For:Site users (with a section to forward to Site IT)
AitriumOS updates itself from inside the app. You don’t need to download anything: the update downloads, installs and reopens AitriumOS for you. AitriumOS only offers updates. It never installs one until you start it.

When to update

Update when either of these happens:
  • The header shows “Update to” and a version number, for example Update to 2.3.5. AitriumOS checks for updates when a session starts and every hour while you’re signed in.
  • An upload error or your trial team asks you to update AitriumOS. For example, an upload can fail with The SFTP server’s security settings aren’t supported by this version of AitriumOS. Please update AitriumOS or contact Aitrium support. See Upload connection troubleshooting.

How to update

AitriumOS header with the green Update to 2.3.5 button selected, showing the current and new version and an Update Now button
1

Finish what you're doing

Let any submission in progress finish first. AitriumOS closes while the update installs.
2

Select Update to …

Select Update to and the version number in the header, at the top right of the window. A panel shows your Current version and the New version.
3

Select Update Now

The button shows Downloading… while the update downloads. This can take a few minutes.
4

Let AitriumOS restart

AitriumOS closes, installs the update and reopens by itself. On Windows, a small installer progress window appears for a moment. Sign in again if asked.
Your sign-in, settings and submitted data are kept. Every update is cryptographically signed and checked before it is installed.
If AitriumOS says Please restart the application manually to complete the update. then close AitriumOS and open it again.

Check your version

Your version is shown in the header:
  • When you’re up to date, the header shows the version number, for example 2.3.5. Select it to see Current version and You’re on the latest version.
  • When an update is available, the header shows Update to and the new version. Select it to see your Current version.
AitriumOS header showing version 2.3.5, with the panel open showing Current version 2.3.5 (NSIS), You're on the latest version and a Check for updates button To check right away, select the version number and then Check for updates. On Windows, the label next to the version shows how AitriumOS was installed: (NSIS) is the Standard installer, which installs for your account only. (MSI) is the MSI installer, which installs for the whole computer.

If the update needs administrator rights or stops

This usually means AitriumOS was installed for the whole computer with the MSI installer, often by your IT team. Updating an MSI install needs administrator rights, so Windows may ask for an administrator’s permission. If you can’t give it, the update stops and your current version stays installed. Open AitriumOS again from the Start menu to keep working. To update an MSI install, ask your IT team to:
  1. Sign in at app.aitriumos.com and open Downloads.
  2. Download the latest MSI installer and install it on your computer. It replaces the current version, and your settings are kept.
If you’d rather not need an administrator for future updates, IT can switch the computer to the Standard installer instead. See Switching Windows installer types. Install only one type, because two installed copies can run different versions.

On macOS

The steps are the same: select Update to, then Update Now, and AitriumOS reopens on the new version. The current macOS release is for Macs with Apple Silicon. If your Mac has an Intel processor, contact Aitrium support. If AitriumOS shows Update failed, your Mac account may not be allowed to change the copy of AitriumOS in Applications, for example because another account installed it. Ask someone with administrator rights on the Mac to download the latest version from app.aitriumos.com → Downloads and install it over the existing copy.

Other problems

Select the version number in the header, then Check for updates. If it then shows You’re on the latest version, no update is currently offered. If your version still differs from what you were told, contact Aitrium support.
The workstation can reach Aitrium but not the update server, so AitriumOS can’t check for or download updates. Ask your IT team to allow storage.googleapis.com (see the firewall allowlist), then select the version number and Check for updates. Until then, IT can download the latest installer from Downloads at app.aitriumos.com on a computer whose network allows that address, then install it on this workstation.
The last update check didn’t succeed. Select Check for updates to try again. If it keeps failing, contact Aitrium support, or ask IT to install the latest version from Downloads at app.aitriumos.com.
The update couldn’t be downloaded or installed. Close and reopen AitriumOS, then try again. If it fails again, contact Aitrium support with the full message.If AitriumOS doesn’t open after a failed update, reinstall the latest version from Downloads at app.aitriumos.com. If AitriumOS was installed with the MSI installer, ask your IT team to install the latest MSI installer.
The computer probably has two copies of AitriumOS, one from each Windows installer type, and the icon you opened is the copy that wasn’t updated. Check Windows Settings → Installed apps for more than one AitriumOS entry and follow Switching Windows installer types to keep only one.

Need help?

Contact Aitrium support with your AitriumOS version, your operating system and the exact message shown in the app.