Quick start

August 7, 2025 ยท View on GitHub

Before setting up the hcloud-cloud-controller-manager you need to configure your cluster appropriately. When creating your cluster you need to provide the kubelet option --cloud-provider=external. How this is done depends on your Kubernetes distribution.

  1. Create a read+write API token in the Hetzner Cloud Console as described in this document.

  2. Create a secret containing your Hetzner Cloud API token:

kubectl -n kube-system create secret generic hcloud --from-literal=token=<hcloud API token>
  1. Add the Helm repository:
helm repo add hcloud https://charts.hetzner.cloud
helm repo update hcloud
  1. Install the chart:
helm install hccm hcloud/hcloud-cloud-controller-manager -n kube-system