Skip to main content

Install the vCluster CLI

Learning objectives

In this guide, you learn the following:

  1. How to install the vCluster CLI.
  2. How to deploy vCluster.
  3. How to connect to vCluster and how vCluster interacts with the host cluster.
  4. How to uninstall vCluster.

These exercises should take about 10 minutes.

You can join the Loft Users Slack to ask questions in the #vcluster channel.


  • vCluster: the product; this also refers to a vCluster installation.
  • vcluster: the CLI.
  • host: The Kubernetes cluster that you install vCluster on.

Before you begin

  • You have read What Are Virtual Clusters.
  • You have installed kubectl (check via kubectl version) and Helm v3.10.0+ (check with helm version).
  • You have access to a Kubernetes cluster to use as the host cluster (check with kubectl get namespaces)

Install the vCluster CLI

Use one of the following commands to download and install the vCluster CLI binary from GitHub:

brew install loft-sh/tap/vcluster

If you installed the CLI using brew install loft-sh/tap/vcluster, you should brew uninstall vcluster and then install using the tap. The binaries in the tap are signed using the Sigstore framework for enhanced security.

Alternatively, you can download the binary for your platform from the GitHub Releases page and add this binary to your PATH.

To confirm that vCluster CLI is successfully installed, test via:

vcluster --version