Skip to main content

Upgrade vCluster Platform

Upgrading vCluster Platform is easy. vCluster Platform can be upgraded either via the vCluster CLI, or with Helm.

Upgrade the platform

Upgrade considerations
  • Review the release notes for the target version to understand any breaking changes or new features.
  • Test the upgrade in a non-production environment before applying it to your production setup.

Upgrade the platform via:

To upgrade the platform using the vcluster CLI, update $PLATFORM_VERSION with a valid platform version and run:

Upgrade the platform using vCluster CLI
RELEASE_NAMESPACE=vcluster-platform # Replace with the namespace of the platform deployment if different
PLATFORM_VERSION='' # Set this to a specific version or leave empty for latest

vcluster platform start --upgrade --version=$PLATFORM_VERSION --namespace=$RELEASE_NAMESPACE --values=vcluster-platform.yaml
Versions and Values

The $PLATFORM_VERSION variable above is an environment variable set to your desired vCluster Platform version to deploy. The vcluster-platform.yaml file is an optional YAML file that contains Helm values you would like to use when upgrading your vCluster Platform deployment.