Skip to main content
Version: v0.38 Stable

vcluster.yaml reference

These pages list every field in vcluster.yaml, the configuration file for a cluster created with vCluster. Each page covers one top-level key and gives each field's type, default, and description. The tables are generated from the vCluster configuration schema, so they match the version of the docs you're reading.

To learn how the file is structured and applied, see What is vcluster.yaml?. For step-by-step configuration, see Configure. The vCluster chart's values.yaml shows every default, and its values.schema.json validates a vcluster.yaml file.

Top-level keys​

KeyWhat it configures
controlPlaneControl plane components, such as the Kubernetes distro, backing store, CoreDNS, and proxy, and how the control plane is deployed and exposed.
deletionDeletion protection and automatic deletion of the cluster.
deployAdd-on components vCluster deploys into the cluster, such as kube-proxy, a CNI, a CSI driver, MetalLB, a metrics server installed in the cluster, Argo CD applications, and Stacks.
experimentalExperimental features. Their configuration might change between releases.
exportKubeConfigHow vCluster exports the cluster's kubeconfig, including the context, server, and target Secrets.
integrationsIntegrations with tools on the control plane cluster, such as cert-manager, External Secrets Operator, Istio, KubeVirt, the control plane cluster's metrics server, Netris, and Argo CD.
loggingLog encoding and log file output.
networkingService replication, DNS resolution, and other networking options.
platformThe connection to vCluster Platform, such as the API key and project.
pluginsWhich vCluster plugins to load.
policiesResource quotas, limit ranges, network policies, Pod Security Standards, and central admission control.
privateNodesPrivate nodes, including kubelet settings, node joining, Auto Nodes, automatic upgrades, and VPN.
rbacThe Role and ClusterRole that vCluster uses on the control plane cluster.
sleepAutomatic sleep and wakeup.
snapshotsAutomatic snapshots.
syncWhich resources sync from the cluster to the control plane cluster, and from the control plane cluster into the cluster.
telemetryUsage telemetry that vCluster collects.