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

# Updates

> How the desktop app and integrations update, automatically or by hand

The desktop app and each integration update separately. Both download in the background; installing an update briefly stops collection, so the gateway waits for a quiet moment unless you install by hand.

## Automatic Updates

**Settings > Application > Allow automatic updates** is on by default. With it on, the gateway installs downloaded updates by itself:

| Update | Installs when |
| - | - |
| **Integration** | The integration has had no active data item and no new data for about 15 minutes. |
| **Revoked integration version** | As soon as possible, even while collecting. |
| **Desktop app** | All integrations are idle, or 48 hours after the update downloaded at the latest. |

Before installing, the app counts down 5 minutes. The **Integrations** page header shows a scheduled-update badge; hover it and click Delay 1 hour to postpone. While you're viewing the integration, a dialog also offers Update now and Delay 1 hour. If collection starts again during the countdown, the update waits for the next quiet period.

Turn Allow automatic updates off to prevent all automatic installs, for example during a long growth campaign. You can still install updates by hand. The same switch is available remotely under the gateway's **Settings** in the web app.

## Installing by Hand

**Integrations.** The app checks for new integration versions at launch and every few minutes; click the refresh button next to the search box to check now. An integration with a new version shows Update available, and its page shows an **Update Available** card. Click Update Integration. A running integration pauses briefly and restarts on the new version; queued data is kept. If the new version changes the configuration format, the saved configuration is migrated automatically.

**Desktop app.** When an app update has downloaded, an Update Available button appears in the **Integrations** page header. To check now, choose Help > Check for updates. Restarting interrupts collection briefly; if integrations are running, the app lists them and asks you to confirm. Updates never need administrator rights.

Some integration versions need a newer desktop app. The update card then says the integration requires an update to the gateway application first. Click Update gateway to download the app update, then restart to install it.

## When an Update Fails

If an integration update fails, the previous version is restored and the integration page shows Update to *version* failed — rolled back to *version*. That version won't install automatically again. Send the message and the [logs](https://docs.atomscale.ai/gateway/reference/files-and-logs.md#collecting-logs-for-support) to Atomscale support.


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