> For the complete documentation index, see [llms.txt](https://docs.acecloud.ai/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acecloud.ai/knowledge-base/kubernetes-hosted/how-to-upgrade-a-hosted-kubernetes-cluster.md).

# How to Upgrade a Hosted Kubernetes Cluster?

## **Overview**

The **Upgrades** tab in Hosted Kubernetes allows you to upgrade the Kubernetes version of a cluster. The upgrade process is performed in two steps:

1. Upgrade the **control plane**.
2. Upgrade the **node groups**.

You must complete the control plane upgrade before upgrading the node groups.

## **View Available Kubernetes Upgrades**

1. Log in to the **AceCloud portal**.
2. Navigate to **Kubernetes > Hosted > Overview**.
3. Select the cluster you want to upgrade.
4. Click the **Upgrades** tab.

![](/files/xHkOUf6Qtyp7QfQpReJr)

The page displays the current Kubernetes versions and available upgrade information, including:

* **Current control plane** version
* **Current worker nodes** version
* **Available upgrade** version
* **End-of-Life (EOL)** date for the current and available versions

**Note:** The available upgrade versions depend on the Kubernetes versions supported by the platform.

## **Step 1: Upgrade the Control Plane**

1. In the **Step 1 of 2: control plane** section, review the available upgrade version.
2. Click **Upgrade control plane to vX.X.X**.

![](/files/lmd6sSKJgxLzRNmxvZ24)

3. Follow the on-screen instructions to confirm the upgrade, if prompted.
4. Wait for the control plane upgrade to complete.

**Important:** The control plane must be upgraded before you can upgrade the node groups.

## **Step 2: Upgrade Node Groups**

After the control plane upgrade is completed, proceed to the **Step 2 of 2: node groups** section.

1. Review the node groups available for upgrade.
2. Select the node groups you want to upgrade.
3. To select all upgradeable node groups, select **Select all upgradeable node groups**.
4. Click **Upgrade selected groups** to upgrade the selected node groups.

Alternatively, click **Upgrade all groups** to upgrade all eligible node groups.

The node group status is displayed on the page after the upgrade.

## **Node Group Upgrade Status**

The **Node Groups** section displays the current and target Kubernetes versions for each node group.

A node group may display **Up to date** when no upgrade is currently required or available for that node group.

## **Upgrade Sequence**

Hosted Kubernetes upgrades must follow this sequence:

**Current Kubernetes Version → Control Plane Upgrade → Node Group Upgrade**

For example:

* Current control plane: **1.34.6**
* Current worker nodes: **1.34.6**
* Available upgrade: **1.35.5**
* First upgrade the control plane from **1.34.6 → 1.35.5**
* Then upgrade the eligible node groups from **1.34.6 → 1.35.5**

**Note:** Upgrade availability and supported target versions may vary based on the cluster's current Kubernetes version.