Prerequisites
ctrlcCLI installed- Kubernetes cluster access (kubeconfig or in-cluster)
- Ctrlplane API key
Basic Usage
Options
| Flag | Description | Required |
|---|---|---|
--cluster-name | Display name for the cluster | Yes |
--cluster-identifier | Unique identifier (or CLUSTER_IDENTIFIER env var) | Yes |
--namespace | Kubernetes namespace (all namespaces if not set) | No |
--provider | Resource provider name | No |
--interval | Sync interval (e.g., 5m, 1h) | No |
Resource Metadata
Each Helm release is synced with metadata:Running in Kubernetes
Deploy as a Deployment:Environment Targeting
Target Helm releases in environments:Best Practices
Sync All Namespaces
Unless you have specific needs, sync from all namespaces:Combine with Kubernetes Sync
Run both Kubernetes and Helm sync:Next Steps
Kubernetes Provider
Sync Kubernetes resources
vCluster Provider
Sync virtual clusters