Skip to main content

Synopsis

Upgrades the vCluster CLI to the latest version.
vcluster upgrade [flags]

Description

The upgrade command downloads and installs the latest version of the vCluster CLI.
This command only upgrades the CLI tool itself, not virtual clusters. To upgrade a running vCluster, use vcluster create --upgrade.

Examples

# Upgrade to latest version
vcluster upgrade

# Check current version first
vcluster --version

What Gets Upgraded

  • vCluster CLI binary - The vcluster command-line tool
  • Not upgraded:
    • Running virtual clusters (must be upgraded separately)
    • Helm charts
    • vCluster Platform components

Upgrading Virtual Clusters

To upgrade a running virtual cluster:
# Upgrade an existing vCluster to latest chart version
vcluster create my-vcluster -n team-x --upgrade

# Upgrade to specific version
vcluster create my-vcluster -n team-x --upgrade --chart-version 0.30.0

Manual Upgrade

If the automatic upgrade fails, you can upgrade manually:
brew upgrade loft-sh/tap/vcluster

See Also

Build docs developers (and LLMs) love