Skip to main content
Version: main 🚧

K0s

Deprecation notice

Support for K0s is deprecated in vCluster v0.25 and removed in v0.26. Migration to a supported Kubernetes distribution is recommended.

Zero Friction Kubernetes (K0s) is an all-inclusive Kubernetes distribution, which is configured with all of the features needed to build a Kubernetes cluster and packaged as a single binary for ease of use. For more information on features, see the K0s documentation.


warning

vCluster does not support dual stack networking when you use k0s. You can deploy K0s on a dual stack host cluster, but it does not have all the dual stack features.

To use K0s with default deployment options, add the following to your vcluster.yaml config file:

controlPlane:
  distro:
    k0s:
      enabled: true
warning

After deploying your vCluster, changing the Kubernetes distribution of vCluster is not supported.

Compatibility matrix​

Host cluster compatibility​

The Kubernetes distro of vCluster is completely independent of the Kubernetes distro of the host cluster. This means you can run vCluster using k0s distribution regardless of the distribution type of the host cluster.

vCluster should work when deployed on a host cluster with the following supported Kubernetes versions:

  • v1.32
  • v1.31
  • v1.30

Config reference​

Configuration for k0s has been deprecated and removed in vCluster v0.26. Please migrate to a supported Kubernetes distribution.