> 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.

![](https://315001803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4J4izUBTSuiTE14qXBAP%2Fuploads%2FCMbNWMlY4dmrmCRUr6IP%2Funknown.png?alt=media\&token=91f1064f-35f3-4328-9437-0fd630e2ce08)

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**.

![](https://315001803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4J4izUBTSuiTE14qXBAP%2Fuploads%2FyZfmDQtZZrYyKyYeERwS%2Funknown.png?alt=media\&token=9428f174-59ab-4f29-ac53-a778f345ce46)

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.

**Note:** Hosted Kubernetes cluster upgrades are performed as a **rolling upgrade**. During the upgrade, workloads are gradually shifted to the newly created nodes. The existing nodes are removed only after their workloads have been successfully rescheduled and the new nodes are ready.

It is recommended to upgrade the cluster **before the current Kubernetes version reaches End of Life (EOL)** to ensure continued support and compatibility.