finds.dev

hcloud-k8s/terraform-hcloud-kubernetes

Terraform Module to Deploy a Highly Available, Production-Ready Talos Kubernetes Cluster on Hetzner Cloud

View on GitHubHomepage ↗

★ 720HCLMITupdated Oct 2026

// the take

A Terraform/OpenTofu module that stands up a full HA Kubernetes cluster on Hetzner Cloud using Talos Linux, bundling CNI, CCM, CSI, backups, and autoscaling. Aimed at teams who already know Terraform and want a declarative, immutable cluster on Hetzner without hand-rolling kubeadm or a managed service that doesn't exist there.

Genuinely production-minded defaults: perimeter firewall, WireGuard/IPsec pod encryption via Cilium, LUKS2 disk encryption per-node with unique derived keys, and a real distinction between public/private cluster access modes with VIP/load-balancer options. Bare metal integration (Robot API, vSwitch, RAID1 install) is a rare feature for a Hetzner module and goes deep enough to handle disk selection and RAID members explicitly. Cluster Autoscaler discovery mode addresses the usual gap where autoscaled nodes never get upgraded. Dual-stack LB with PROXY protocol and Gateway API wiring (plus a working cert-manager + Hetzner DNS-01 example) is unusually complete for a community module.

Everything is hard-pinned to Hetzner Cloud and Talos — there's no path off either without rebuilding the cluster, which matters since Talos has its own learning curve (no shell/SSH, API-driven config) on top of Terraform's. Bare metal provisioning is explicitly destructive by default (wipes every eligible disk) and RAID config only applies at initial provisioning, so a wrong setting isn't fixable without reprovisioning the box. IPv6 pod networking is flagged experimental and explicitly 'not supported for production' by the authors themselves, so dual-stack shops are stuck on IPv4-only pods for now. Hcloud CSI StorageClasses are immutable post-creation — changing fsType or encryption means deleting from both Terraform state and the cluster. With 720 stars and a single small org behind it, you're trusting one group's judgment on CVE response and Talos/Kubernetes version compatibility windows.

We read the README, the directory tree and a key source file in November 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
720
Forks
87
Language
HCL
License
MIT
Last commit
31 Oct 2026

// nearby

If terraform-hcloud-kubernetes isn't quite it.

All repos →