#156156th of 275 in Backends, databases and hosting
terraform-hcloud-kube-hetzner
Terraform/OpenTofu module that builds k3s or RKE2 clusters on Hetzner Cloud
- Stars
- 4k
- License
- MIT
- Last commit
- Sep 2026
- Last release
- Sep 2026
- Language
- HCL
3,775 on 29 Apr 20263,951 on 18 Nov 2026
From GitHub's daily star counts.
Checked on GitHub.
Overview
Kube-Hetzner is a Terraform/OpenTofu module that provisions a Kubernetes cluster on Hetzner Cloud, running k3s or RKE2 on openSUSE Leap Micro nodes. It wires in private networking, firewalls, CSI storage, ingress, cert management, and automatic OS and Kubernetes upgrades. A `createkh` script generates the project folder, `kube.tf`, and node images.
Who it is for: Self-hosters and platform engineers running Kubernetes on Hetzner Cloud
Strengths
- HA control plane, multi-location pools, and Cluster Autoscaler nodepools
- Choice of k3s or RKE2, and Flannel, Calico, or Cilium networking
- Plan-time validation rejects invalid topology and variable combinations before apply
- State-aware destroy script reports possible Hetzner orphans; ships agent skills for migration and upgrades
Weaknesses
- Hetzner Cloud only; Robot dedicated servers need a separate integration
- Requires Packer to build Leap Micro images alongside Terraform/OpenTofu and hcloud
- v2 to v3 upgrade needs a manual migration; blind apply is discouraged
- Cloudflare Mesh/WARP is not supported as node transport
What it needs
- no GPU
- Needs Hetzner Cloud account and API token, OpenTofu or Terraform >= 1.10.1, Packer 1.16.0, kubectl, hcloud CLI
What changed
- v3.2.1 ↗ (opens in a new tab)Breaking
“The migration plan auditor now blocks standalone server-network detachment and flags in-place private/public networking changes. A plan with no server replacement is not sufficient proof of IP/MAC pr…”
- v3.2.0 ↗ (opens in a new tab)Breaking
“Force cleanup scope and timeout: cleanupkh now treats the HCloud project selected by the Terraform token as dedicated to one cluster and proposes deleting every runtime resource in that project, incl…”
- v3.1.0 ↗ (opens in a new tab)Breaking
“IPv6/dual-stack clusters: static control-plane and agent nodes now render node-ip values that match the configured cluster CIDR families when clusteripv6cidr / serviceipv6cidr are set. Do not enable …”
From the release notes. No flag means the note does not say so, not that the upgrade is safe.
Known problems
Open now, reported in the last 90 days
- Packer security bundle requires exactly 1.16.0, rejects newer 1.16.x ↗ (opens in a new tab)1 reactions
Reported, then fixed by a linked change
- [Bug]: invalid input in field 'health_check' ↗ (opens in a new tab)4 reactions · closed 2 Jun 2026Fixed by Prepare v2.20.0 candidate fixes ↗ (opens in a new tab)
- [Bug]: Packer fails creating MicroOS snapshots due to server availability ↗ (opens in a new tab)2 reactions · closed 3 Jul 2026Fixed by fix(packer): expose server type/location overrides for snapshot builds ↗ (opens in a new tab)
- [Bug]: if nat_router is not enabled, its validation fails tf validate/apply ↗ (opens in a new tab)2 reactions · closed 25 Apr 2026Fixed by Fix nat_router validation when variable is null ↗ (opens in a new tab)
- [Bug]: Attachment IP is outside subnet IP range ↗ (opens in a new tab)2 reactions · closed 11 Jan 2026Fixed by Fix load balancer IP configuration for hcloud provider 1.56+ ↗ (opens in a new tab)
- [Bug]: SELinux and Healthchecks hcloud-csi-driver ↗ (opens in a new tab)1 reactions · closed 3 Jul 2026Fixed by fix(selinux): allow container liveness probes on kernel-labeled tcp sockets ↗ (opens in a new tab)
Titles are the reporters' own words, taken from the project's GitHub issues and ranked by reactions. We have not tried to reproduce any of them.
Also in Backends, databases and hosting
See all 275| Rank | Project | Score |
|---|---|---|
| 1 | bunJavaScript and TypeScript runtime with bundler, test runner and package manager | 94 out of 100 |
| 2 | coolifySelf-hosted Heroku and Vercel alternative that deploys apps and databases over SSH | 93 out of 100 |
| 3 | traefikHTTP reverse proxy and load balancer that auto-discovers routes from orchestrators | 93 out of 100 |
| #4 | appwriteBackend with auth, databases, storage, functions and an MCP server for agents | 93 out of 100 |
| #5 | medusaNode.js commerce platform with modular products, carts, orders and payments | 93 out of 100 |