Open SourceFreeEnterprisePlatform

vCluster

Free, open-source tool that creates virtual Kubernetes clusters. Each tenant gets its own API server, CRDs, and RBAC on a shared cluster.

What is vCluster?

vCluster is a free, open-source tool that creates virtual Kubernetes clusters, called tenant clusters. Each tenant cluster runs inside a normal Kubernetes cluster, but it works like a real, separate cluster.

Every tenant cluster gets its own API server, CRDs, and RBAC. So a team or customer can be cluster-admin in their own cluster while having only limited permissions on the underlying main cluster.

A tenant cluster is upstream Kubernetes, so kubectl, Helm, Argo CD, operators, and CRDs work as usual. vCluster is a CNCF Certified Kubernetes distribution.

vCluster is built by vCluster Labs and is licensed under Apache 2.0.

To learn more, read the official vCluster docs or explore more Kubernetes tools.

Why is it used?

Many teams share one Kubernetes cluster. With plain namespaces, they cannot install their own CRDs, get cluster-admin access, or change cluster-wide settings. But giving every team its own real cluster costs a lot and is hard to manage.

vCluster gives each team or customer its own cluster. It is quick to create and cheap to run, on top of the clusters you already have.

  • Give each team or customer its own Kubernetes cluster
  • Each tenant cluster has its own API server, CRDs, and RBAC
  • Tenants get admin access without risk to the main cluster
  • Create a new cluster with one command
  • Cut cost by sharing nodes and platform tools
  • Use kubectl, Helm, Argo CD, and operators as usual

What problem does it solve?

Namespaces are the usual way to share a cluster, but their isolation is weak. All teams share one API server, so CRDs and cluster-wide settings can clash, and nobody can be a true cluster admin.

The other option is one real cluster per team. That gives strong isolation, but it means many control planes, more cost, and much more work to run.

Before: Teams fight over one shared cluster, or you pay for and manage dozens of separate clusters.
After: Each team gets its own tenant cluster with full admin access, while you run only a few host clusters.

How does it work?

vCluster demo: create a tenant cluster for team-a, install a CRD in it, then switch to team-b and see that the CRD is not there

(Official vCluster demo: a CRD made in team-a's cluster is not seen in team-b's cluster.)

How vCluster works:

1. You run vcluster create my-vcluster --namespace team-x. vCluster installs a tenant cluster into that namespace on your existing cluster (the Control Plane Cluster).

2. The tenant cluster runs its own control plane: an API server, a controller manager, and a data store (embedded etcd or an external database).

3. vCluster switches your kube context to the new cluster. You use kubectl, Helm, and other tools as usual, with full admin rights inside it.

4. In Shared Nodes and Dedicated Nodes modes, vCluster syncs the pods and services you create down to the host cluster, so they run on its nodes, network, and storage. In Private Nodes and Standalone modes, the tenant cluster brings its own nodes, CNI, and CSI for stronger isolation.

Run vcluster disconnect to go back to your original kube context.

Key features of vCluster

Everything you need to give each team or customer its own Kubernetes cluster.

  • Own API server per tenantEach tenant cluster runs its own control plane, not just a namespace.
  • Strong isolationTenants are admin in their cluster but have few rights on the host.
  • Fast to createMake a tenant cluster with one vcluster create command.
  • Resource syncingSyncs pods, services, secrets, and more to the host cluster.
  • Shared platform stackReuse the host CNI, CSI, and ingress in shared modes.
  • Private NodesFull CNI and CSI isolation on nodes that belong to one tenant.
  • Standalone modeRun without a host cluster, on bare metal or dedicated machines.
  • Runs on DockerRun a full tenant cluster in Docker with --driver docker.
  • Snapshot and restoreSave a tenant cluster to S3, OCI, Azure Blob, or local storage.
  • Auto NodesAdd and remove private nodes automatically with Karpenter.
  • GPU-aware schedulingSupports Dynamic Resource Allocation for GPU workloads.
  • High availabilityMultiple replicas with embedded etcd or an external database.

Advantages and limitations

Advantages

  • Free and open source (Apache 2.0)
  • Real cluster-level isolation, stronger than namespaces
  • Much cheaper than running many separate clusters
  • Works with standard Kubernetes tools, with no changes
  • CNCF Certified Kubernetes distribution
  • Many modes, from shared nodes to bare metal

Limitations

  • Adds another layer to learn and run on top of Kubernetes
  • In Shared Nodes mode, tenants share nodes, CNI, and CSI, so isolation is weaker
  • Some features, like Sleep mode and Node VPN, need the vCluster Platform
  • Slurm, Ray, Run:ai, and inference clusters come with the vCluster Platform, not the open-source repo
  • Each tenant cluster runs its own control plane, which uses extra CPU and memory

IN REAL PROJECTS

Who uses vCluster in production?

These results come from vCluster's official case study pages.

Atlan

Cluster consolidation

Atlan went from 100 clusters down to 1 with vCluster.

Read case study (opens in a new tab)

Fortune 500 Insurance Company

Cost savings

A Fortune 500 insurance company cut its Kubernetes cost by 70%.

Read case study (opens in a new tab)

Aussie Broadband

Faster provisioning

Aussie Broadband made cluster provisioning 99% faster.

Read case study (opens in a new tab)

Ada

Developer productivity

Ada got 10x developer productivity with vCluster.

Read case study (opens in a new tab)

Lintasarta

Production scale

Lintasarta runs 170+ tenant clusters in production.

Read case study (opens in a new tab)

Nebius

AI cloud

Nebius uses vCluster for tenant isolation in its AI cloud.

Read case study (opens in a new tab)

vCluster FAQ

What is vCluster?

vCluster is a free, open-source tool that creates virtual Kubernetes clusters, called tenant clusters. Each one has its own API server, CRDs, and RBAC, and runs on top of an existing cluster or on its own.

Is vCluster free?

Yes. The open-source vCluster is free under the Apache 2.0 license. There is also a vCluster Platform with a free tier (up to 64 CPUs and 32 GPUs) and paid plans.

How do I install vCluster?

Install the CLI with brew install loft-sh/tap/vcluster. You need a running Kubernetes cluster and kubectl set up.

How do I create a virtual cluster?

Run vcluster create my-vcluster --namespace team-x. Then use kubectl as usual, for example kubectl get namespaces.

Can I run vCluster without a Kubernetes cluster?

Yes. Use vind (vCluster in Docker) with vcluster create my-vcluster --driver docker. You can also run vCluster Standalone on bare metal.

How is a vCluster different from a namespace?

A namespace shares one API server with everyone. A vCluster has its own API server, CRDs, and RBAC, so tenants can be cluster-admin and install CRDs without affecting others.

Is vCluster certified Kubernetes?

Yes. vCluster is a CNCF Certified Kubernetes distribution, and it is Kubernetes AI Conformant.

Who uses vCluster?

vCluster says it runs in production at companies like Adobe, CoreWeave, NVIDIA, Nebius, and Deloitte.