Skip to main content
You can set the Kubernetes version 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.

​
How to set a Kubernetes version

  1. In the sidebar, go to https://mintcdn.com/nebius-ai-cloud/rOlLZ_MFvrheaI-h/_assets/sidebar/compute.svg?fit=max&auto=format&n=rOlLZ_MFvrheaI-h&q=85&s=8d3eda9b92f5a626a81d01268852f482 Compute → Kubernetes.
  2. Click https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/plus.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=7c9efc69d65fc58db0eb73702fd81aa1 Create cluster.
  3. In the Control plane section, select the Kubernetes version from the drop-down list.
It is not currently possible to set a Kubernetes version for a node group in the web console.

​
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.
  1. Get the ID of the cluster: 
    nebius mk8s cluster get-by-name \
  --name <cluster_name> --format json | jq -r '.metadata.id'
  2. Upgrade the control plane: 
    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: 
    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: 
    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.