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

# Upgrade your Controller and Gateways via CoPilot UI

> Upgrade Aviatrix Controller and Gateways through the CoPilot UI with prechecks and verification.

<Note>
  If your Controller version is 7.0 or earlier, use Controller UI for the
  Controller and Gateway upgrade. See{" "}
  <a href={"/docs/enterprise/" + "8.2" + "/guides/maintenance/controller-gateway-upgrade-controller"}>Upgrade your Controller via the Controller UI</a>
</Note>

This page instructs you on how to perform single-version Controller and Gateway
upgrade. For multiple-version Controller and Gateway upgrade, see

<a href={"/docs/enterprise/" + "8.2" + "/guides/maintenance/controller-gateway-upgrade-latest-image"}>Upgrade your Controller and Gateways to the Latest Aviatrix Supported Images
(AWS and Azure Only)</a>
.

## Before Upgrade

Before upgrading your Controller and Gateways, it is highly recommended to check
the

<a href={"/docs/enterprise/" + "8.2" + "/guides/maintenance/upgrade-overview"}>General Controller and Gateways Upgrade Guidance</a>
.

* You must upgrade the Controller first, ensuring it is at the desired release
  version.
* Once the Controller upgrade is completed successfully, you proceed to upgrade
  the Gateways.

### Review the Pre-upgrade Tasks

Check and perform all the pre-upgrade tasks. See details in

<a href={"/docs/enterprise/" + "8.2" + "/guides/maintenance/controller-upgrade-planning"}>Pre-upgrade Tasks for Controller and Gateways</a>
.

### Check the Upgrade Checklist

Perform all the items listed in the upgrade checklist. See details in

<a href={"/docs/enterprise/" + "8.2" + "/guides/maintenance/controller-upgrade-checklist"}>Upgrade Checklist of the Controller and Gateway Upgrade</a>

The following table outlines the steps involved in upgrading the Controller and
Gateways when upgrading between different versions.

<a id="upgrade-controller" />

## Upgrade your Controller

Perform the following steps to upgrade your Controller to a desired version:

1. Log into your CoPilot.
2. Go to **Settings > Maintenance > Upgrade**, click **Upgrade** under the
   Controller card. &#x20;
3. Enter the release number to which you want to upgrade. By default, it will
   upgrade to the latest version of the current release. Alternatively, you can
   specify a specific release version.

Click **Upgrade** to initiate the Controller upgrade process.

<a id="upgrade-gateways" />

## Upgrade your Gateways Perform the following steps to upgrade your Gateways to

a desired version:

1. Log into your CoPilot.

2. Go to **Settings > Maintenance > Upgrade**.

3. Click **Prepare For Upgrade** under the Controller card and select **Software
   Upgrade**.
   1. Choose the gateways you want to upgrade from the dropdown list. However,
      please note that the system will upgrade the Controller first and then the
      gateways.
   2. Click **Dry Run** to check for potential issues.
   3. (Optional) If any issues are reported, address and fix them accordingly.
   4. Click **Upgrade** to upgrade the selected gateways.

4. Alternatively, go to **Cloud Fabric > Gateways > Gateway Management** and
   click **Software Upgrade**.
   1. Select the gateways you want to upgrade.
   2. Click **Actions > Upgrade Software**.

5. Wait for the upgrade process to complete and verify that you receive a
   successful upgrade message.

<Note>
  * Upgrade HA (High Availability) gateways first, then upgrade primary gateways:
  * To ensure proper continuity and system availability, it is recommended to upgrade HA gateways before upgrading primary gateways. This sequence minimizes any potential disruptions during the upgrade process.
  * After upgrading your HA gateways, upgrade the primary gateways.
</Note>

If you wish to organize gateways into groups and upgrade them in batches, see

<a href={"/docs/enterprise/" + "8.2" + "/guides/maintenance/gateway-upgrade-groups"}>Upgrade Gateways in Groups</a>
.

## Verify your Upgrade Status

After performing an upgrade, it is important to

<a href={"/docs/enterprise/" + "8.2" + "/guides/maintenance/controller-gateway-upgrade-verify"}>verify your upgrade status</a>
.


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