> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aitriumos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Updating AitriumOS

> Update AitriumOS from inside the app, check which version you have, and what to do if an update needs administrator rights.

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](https://docs.aitriumos.com/aitrium-os/connection-troubleshooting.md#what-the-messages-mean).

## 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](https://mintcdn.com/aitrium/m6oBxpLSJaADkFqC/images/update-available.png?fit=max\&auto=format\&n=m6oBxpLSJaADkFqC\&q=85\&s=616cd9c9c165f47ff1a20fa8d177cf50)

**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.

> [!NOTE]
>
> 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](https://mintcdn.com/aitrium/m6oBxpLSJaADkFqC/images/version-current.png?fit=max\&auto=format\&n=m6oBxpLSJaADkFqC\&q=85\&s=01692b9b95d71e42259eee9e083d01f4)

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](https://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](https://docs.aitriumos.com/aitrium-os/overview.md#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](mailto:support@aitriumos.com).

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](https://app.aitriumos.com) → **Downloads** and install it over the existing copy.

## Other problems

> [accordion] I was told to update, but the header doesn't show “Update to”
>
> 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](mailto:support@aitriumos.com).

> [accordion] “Updates unavailable” in the header
>
> 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](https://docs.aitriumos.com/security/aitrium-os/data-flows.md#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](https://app.aitriumos.com) on a computer whose network allows that address, then install it on this workstation.

> [accordion] “Couldn't check for updates”
>
> The last update check didn't succeed. Select **Check for updates** to try again. If it keeps failing, contact [Aitrium support](mailto:support@aitriumos.com), or ask IT to install the latest version from **Downloads** at [app.aitriumos.com](https://app.aitriumos.com).

> [accordion] “Update failed”
>
> The update couldn't be downloaded or installed. Close and reopen AitriumOS, then try again. If it fails again, contact [Aitrium support](mailto:support@aitriumos.com) with the full message.
>
> If AitriumOS doesn't open after a failed update, reinstall the latest version from **Downloads** at [app.aitriumos.com](https://app.aitriumos.com). If AitriumOS was installed with the MSI installer, ask your IT team to install the latest MSI installer.

> [accordion] AitriumOS still shows the old version after updating, or there are two AitriumOS icons
>
> 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](https://docs.aitriumos.com/aitrium-os/overview.md#switching-windows-installer-types) to keep only one.

## Need help?

Contact [Aitrium support](mailto:support@aitriumos.com) with your AitriumOS version, your operating system and the exact message shown in the app.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.