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

# App updates

> How the desktop app checks for, downloads and installs new versions: update entry points, each state and handling failures, restart rules, and the automatic checking and automatic downloading switches.

**App updates** apply only to the desktop app. By default, the app checks for new versions automatically and downloads them in the background, then prompts you to restart to finish installing. You can also check manually at any time, or turn off automatic downloading or automatic checking. The web app has no update entry points. Refreshing the page loads the latest version.

## Availability

| Platform | Support | Notes |
| - | - | - |
| Desktop app | Supported | Everything on this page |
| Web app / Mobile web | Not applicable | Refreshing the page loads the latest version |

## Where to find it

The following entry points share the same update state: an action in one place is reflected in the others.

* **Account menu**: the update row below **Appearance**. By default it shows **Check for updates** and the current version number.
* **Icon bar update button**: at the bottom of the icon bar, above your avatar. It appears only when an update is available, downloading, failed to download or waiting for a restart.
* **Settings › General › Updates**: two switches and the version status.
* **Command menu**: search for **Check for updates**.

## Check for updates manually

1. In the account menu, click **Check for updates** (or click **Check for updates** in **Settings › General › Updates**).
2. When the check finishes:
   * Already up to date: you see **Up to date · vX.Y.Z**.
   * New version found: with automatic download on, it downloads in the background right away. Otherwise, the entry point changes to **Update available** and waits for you to click to download.
   * Check failed: you see **Could not check for updates. Check your network and try again**, and the entry point changes to **Retry update check**.

## Download and install

1. When the entry point shows **Update available**, click it (in Settings, the button is **Download and install**) to start the download. Each entry point shows the download progress.
2. When the download finishes, you see **vX.Y.Z downloaded. Restart to finish updating**, and every entry point changes to **Restart to update**. The app does not restart automatically.
3. Click **Restart to update** to open the confirmation dialog:
   * No local tasks running on this computer: choose **Later** or **Restart now**.
   * Local tasks still running on this computer: choose **Later** or **Restart after tasks**.
4. After the restart, you see **Updated to version**.

Restarting does not affect cloud tasks, and they continue to show after the restart.

### Restart after tasks on this computer finish

After you choose **Restart after tasks**:

* Settings shows which tasks it is waiting for (for example **Waiting for “task title” to finish**). After all of these tasks finish, the app restarts automatically to finish the update.
* While waiting, you can click **Cancel restart**. The update stays downloaded, and you can click **Restart to update** again later.

## Rules and states

| State | What you see | What you can do |
| - | - | - |
| Update available | **Update available** + the new version number; the icon bar button has an alert dot | Click to download and install |
| Update required | Settings shows **Current vold is out of date. Update to vnew to keep using the app** | Download and install soon |
| Downloading | Progress percentage, not clickable | Wait |
| Download failed | **Download failed · retry** | Check your network and click to retry |
| Couldn't prepare the update | **Couldn’t prepare the update** · **Try again, or download the installer and install it manually** | Click **Retry** to download again, or **Download manually** to download the installer and install it yourself |
| Waiting for restart | **Restart to update** | Restart, or wait until later |
| Waiting for local tasks | **Restart after tasks** | Wait for the automatic restart, or **Cancel restart** |
| Restart failed | **Restart failed. Try again or quit and reopen the app** | Restart again, or quit and reopen the app |

* **Update required**: appears when the current version is lower than the minimum required version. You can keep using the interface. Update soon.
* **Couldn't prepare the update**: on macOS, appears when the installer is not ready for a long time after the new version finishes downloading, or preparation fails (it does not stay at 100%). With automatic download on, the app retries automatically in the background.

## Automatic checking and automatic downloading

**Settings › General › Updates** has two switches:

| Switch | Default | Description |
| - | - | - |
| Automatically check for updates | On | Checks for new versions periodically |
| Automatically download updates | On | Downloads new versions in the background, then prompts you to restart when done |

| Combination | After a new version is found |
| - | - |
| Both on (default) | Downloads in the background, then prompts you to restart when done |
| Only automatic checking on | The entry point changes to **Update available**, and you click to download |
| Automatic checking off | **Automatically download updates** is grayed out; new versions are not found automatically, so you check manually and click to download |

When you turn automatic checking back on, automatic download returns to your previous choice. After a download fails, the app retries automatically in the background. You can retry at any time by clicking **Check for updates** or **Download failed · retry**.

## Notes and limitations

* Updates affect only the desktop app itself. They do not affect cloud servers or cloud tasks.

## FAQ

### Why can I only choose "Restart after tasks" when I click "Restart to update"?

Local tasks are still running on this computer. To avoid interrupting them, the app waits for them to finish before restarting automatically. You can also click **Cancel restart** and restart later. Cloud tasks are not affected.

### What should I do if the download stays at 100%?

Wait a moment. If the installer is still not ready, it shows **Couldn’t prepare the update**. Click **Retry** to download again, or click **Download manually** to download the installer and install it yourself.

### What should I do if the download fails?

Check your network, then click **Download failed · retry**.

### How do I update the web app?

The web app does not need manual updates. Refreshing the page loads the latest version.

## Related

* [General and Appearance](https://docs.aihubmix.com/en/cloud/settings/general.md)
* [Account menu and overlays](https://docs.aihubmix.com/en/cloud/interface/command-and-menus.md)


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