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

# Setting and upgrading Kubernetes® versions in Managed Service for Kubernetes

You can set the [Kubernetes version](https://kubernetes.io/releases/) that is used on your Managed Kubernetes clusters and node groups during creation. For existing clusters and node groups, you can upgrade the version.

For more information about available versions and the upgrade, see [Kubernetes® versions in Managed Service for Kubernetes](./versions).

## How to set a Kubernetes version

<Tabs>
  <Tab title="Web console">
    1. In the sidebar, go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/compute.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=b91340217b08a1456d88ae0347f281d1" width="16" height="16" data-path="_assets/sidebar/compute.svg" /> **Compute** → **Kubernetes**.
    2. Click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/plus.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=7c9efc69d65fc58db0eb73702fd81aa1" width="16" height="16" data-path="_assets/plus.svg" /> **Create cluster**.
    3. In the **Control plane** section, select the Kubernetes version from the drop-down list.

    <Note>
      It is not currently possible to set a Kubernetes version for a node group in the web console.
    </Note>
  </Tab>

  <Tab title="CLI">
    Use the following parameters:

    * For clusters ([nebius mk8s cluster create](/cli/reference/mk8s/cluster/create)):

      ```sh theme={null}
      --control-plane-version <major.minor>
      ```

    * For node groups ([nebius mk8s node-group create](/cli/reference/mk8s/node-group/create)):

      ```sh theme={null}
      --version <major.minor>
      ```

          <Warning>
            The Kubernetes version for a node group must not be higher than for the control plane.
          </Warning>
  </Tab>
</Tabs>

## How to upgrade a Kubernetes version

To upgrade a Managed Kubernetes cluster to a new version, upgrade the control plane first and then the node groups.

<Tabs>
  <Tab title="CLI">
    1. Get the ID of the cluster:

       ```bash theme={null}
       nebius mk8s cluster get-by-name \
         --name <cluster_name> --format json | jq -r '.metadata.id'
       ```

    2. Upgrade the control plane:

       ```bash theme={null}
       nebius mk8s cluster update \
         --id <cluster_ID> \
         --control-plane-version <major.minor>
       ```

    3. After the upgrade is completed, get the ID of the node group:

       ```bash theme={null}
       nebius mk8s node-group get-by-name \
         --parent-id <cluster_ID> \
         --name <node_group_name> --format json | jq -r '.metadata.id'
       ```

    4. Upgrade the node group:

       ```bash theme={null}
       nebius mk8s node-group update \
         --id <node_group_ID> \
         --version <major.minor>
       ```

       The Kubernetes version for a node group must not be higher than for the control plane.
  </Tab>
</Tabs>