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/1Ha0sWR6e1mnIaHS/_assets/sidebar/compute.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=b91340217b08a1456d88ae0347f281d1 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.