> ## 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/" + "9.0" + "/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/" + "9.0" + "/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/" + "9.0" + "/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/" + "9.0" + "/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/" + "9.0" + "/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 **Administration > Maintenance > Controller Upgrade**.
3. Select the **Target Version** 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.
4. Click **Run Readiness Check** and resolve any **Failed (Blocker)** issues
   before you continue. See
   <a href={"/docs/enterprise/" + "9.0" + "/guides/maintenance/controller-upgrade-readiness-check"}>Readiness Check for the Aviatrix Controller Upgrade</a>
   .

Follow the on-screen prompts to start 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 **Administration > Maintenance > Gateway Upgrade**.

3. Create or select an upgrade group and choose the gateways you want to
   upgrade. However, please note that the system will upgrade the Controller
   first and then the gateways.
   1. Click **Run Readiness Check** to check for potential issues.
   2. (Optional) If any issues are reported, address and fix them accordingly.
   3. Click **Prepare For 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/" + "9.0" + "/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/" + "9.0" + "/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.