Skip to main content
Version: main 🚧

Choose a control plane deployment

Every cluster has its own control plane. Where that control plane runs is the first decision for a production cluster, and it follows from the infrastructure you already have.

DeploymentWhere the control plane runsUse it whenLicense
Kubernetes podAs pods on an existing Kubernetes clusterYou already run Kubernetes and want to run clusters on itOpen source
Standalone binaryAs a systemd service on its own Linux nodesYou start from bare metal or VMs with no KubernetesNone for a single control plane node. High availability needs embedded etcd, which needs the Free tier or higher.
Container (vind)In Docker containers, alongside containerized worker nodesYou need a cluster for local development or CINone needed

Kubernetes pod​

The control plane runs as pods on a Kubernetes cluster you already operate, such as EKS, GKE, AKS, OpenShift, or a self-managed cluster. That cluster becomes the control plane cluster, and one control plane cluster can host many clusters.

Worker nodes come from one of two models. Shared nodes are the control plane cluster's own nodes. Private nodes join a single cluster and nothing else. See Decide whether tenants share hardware for that decision.

To deploy, see Deploy on a Kubernetes cluster.

Standalone binary​

vCluster Standalone runs the control plane directly on Linux nodes, with no Kubernetes cluster underneath. It needs its own node for the control plane. You can add control plane nodes later for high availability, and worker nodes join as private nodes.

Standalone supports fewer backing stores than a pod-based control plane. See Choose a backing store.

Standalone also solves the first-cluster problem. To host pod-based clusters on bare metal, deploy Standalone first, then install vCluster Platform on it with Helm. The Standalone cluster becomes the control plane cluster for everything you build on top.

To deploy, see vCluster Standalone.

Container (vind)​

vind runs the control plane and worker nodes as Docker containers, and Docker is its only requirement. Use it for local development, offline CI pipelines, and testing configuration before you deploy a production cluster.

To deploy, see Deploy with Docker.

Decide before you deploy​

Choose the deployment before you create the cluster. Moving to a different deployment means creating a new cluster.

Two other choices are also fixed at creation:

Next steps​