Skip to main content
Version: main 🚧

Lifecycle policy

The following defines vCluster's lifecycle policy for releases and maintenance.

vCluster follows a regular release cadence and adheres to semantic versioning. We recommend that users run the latest stable release to stay up to date with new features and security patches.

Due to rapid development, each minor version receives active support for 3 months after its release. Active support ends on the End of Support (EOS) date. After the EOS date, the version enters the End of Support (EOS) period, during which only critical security updates are backported. After the End of Life (EOL) date, the version enters the End of Life (EOL) period, during which no updates are provided.

During active support, updates from the active development branch can be backported upon request.

Versions not listed under End of Support (EOS) or End of Life (EOL) are considered unsupported.

vCluster releases​

ReleaseReleasedEnd of Support (EOS) DateEnd of Life (EOL) Date
v0.342026 Apr 292026 Jul 292026 Oct 29
v0.332026 Mar 132026 Jun 132026 Sep 13
v0.322026 Feb 182026 May 182026 Aug 18
v0.312026 Jan 292026 Apr 292026 Jul 29
Versions below are no longer supported
v0.302025 Oct 282026 Jan 282026 Apr 28
v0.292025 Oct 012026 Jan 012026 Apr 01
v0.282025 Sep 082025 Dec 082026 Mar 08
v0.272025 Aug 122025 Nov 122026 Feb 12
v0.262025 Jun 262025 Sep 262025 Dec 26
v0.252025 May 152025 Aug 152025 Nov 15
v0.242025 Mar 182025 Jun 162025 Sep 14
v0.232025 Feb 262025 May 252025 Aug 26
v0.222024 Dec 182025 Mar 182025 Jun 18
v0.212024 Nov 112025 Feb 112025 May 11
v0.202024 Aug 142024 Nov 142025 Feb 14
v0.192024 Feb 122025 Apr 01*2025 Jul 01

* Extended support: Due to the number of breaking changes from v0.19 to v0.20, the active support period for v0.19 has been extended. Review the migration guide to upgrade your v0.19 virtual clusters to v0.20.

Support terminology

  • End of Support (EOS): The period when active support for a version has ended and only critical security updates are provided. This period begins on the EOS date and lasts 3 months.

  • End of Life (EOL): The period when all support, including security updates, has ended for a version. This period begins on the EOL date and continues indefinitely.

Kubernetes compatibility matrix​

The matrix below shows compatibility between control plane clusters and tenant clusters running vanilla Kubernetes. It specifies which versions of vanilla Kubernetes on the control plane cluster support which versions on the tenant cluster.

When a new Kubernetes version is released, conformance tests are conducted on the latest vCluster version within 30 days.

Kubernetes versions that are no longer supported upstream can still be used but are not guaranteed to work.

Host Cluster Kubernetes VersionvCluster Kubernetes Version
v1.35v1.34v1.33v1.32v1.31v1.30
v1.35✅🆗🆗🆗🆗🆗
v1.34🆗✅🆗🆗⚠️1⚠️1
v1.33🆗🆗✅🆗🆗🆗
v1.32🆗🆗🆗✅🆗🆗
v1.31🆗🆗🆗🆗✅🆗
v1.30🆗🆗🆗🆗🆗✅
  • ✅ Tested and verified – Officially tested and supported.
  • 🆗 Likely compatible – Expected to work, but not officially tested.
  • ⚠️ Known issues – Compatible with documented limitations.
  1. EndpointSlice sync from host may fail due to API changes introduced in Kubernetes 1.34. See endpoint slices documentation for details.

Feature Versioning​

While most features we release are fully supported, some are introduced at an earlier stage of development. These stages generally align with Kubernetes conventions, with the exception of experimental features which may be removed at any time.

  • Alpha: Newly introduced features which may include breaking changes in future releases.

  • Beta: Features that are more stable and considered safe, but not recommended for business critical applications.