---
title: "Upgrade in an air-gapped Embedded Cluster environment"
description: ""
url: "https://docs.itrsgroup.com/docs/itrs-analytics/platform/2.18.0/install/upgrade-airgap-ec/index.html"
---

**Note**


Before upgrading ITRS Analytics, please review the [ITRS Analytics Upgrade Notes](https://docs.itrsgroup.com/docs/itrs-analytics/platform/2.18.0/upgrade/itrs-analytics-upgrade-notes/index.html) for important considerations. This is essential to avoid potential issues with your current setup, especially concerning configuration changes.



To upgrade an airgap install, you can either upload a new airgap bundle from the command line or to the KOTS admin console.

1. Log into a controller node in the cluster via SSH, and then download the airgap bundle for the new version. Run:

  ```
  curl -f [download URL]/[channel]?airgap=true -H "Authorization: [authorization key]" -o [itrs-analytics]-[channel].tgz
  ```

2. Extract the installation bundle. Run:

  ```
  tar -zxvf [itrs-analytics]-[channel].tgz
  ```

3. Do one of the following:

  | Method | Steps       |
  |--------|-------------|
  | **Upload the bundle from the command line** | Run: ```
./[itrs-analytics] update --airgap-bundle [itrs-analytics].airgap
```
After the airgap bundle has been uploaded, from the same machine, access the KOTS admin console on a browser. | 
  | **Upload the bundle from the KOTS admin console using a browser** | On the **Version history** page, click **Upload new version**, and then select the airgap bundle you downloaded.|

4. From the **Version history** page in admin console, click **Deploy** next to the new version.
  
  ![Airgap upgrade](https://docscdn.itrsgroup.com/obcerv-platform/images/replicated-admin-console-airgap-upgrade-2-7-1.png)

5. Follow the rest of the prompts in the admin console until the upgrade has successfully completed.

If the upgrade fails, see [Recovery from a failed upgrade](https://docs.itrsgroup.com/docs/itrs-analytics/platform/2.18.0/upgrade/recovery-from-failed-upgrade/index.html).

