#156156th of 275 in Backends, databases and hosting

terraform-hcloud-kube-hetzner

Terraform/OpenTofu module that builds k3s or RKE2 clusters on Hetzner Cloud

Releases and problems feed (RSS)

Stars
4k
License
MIT
Last commit
Sep 2026
Last release
Sep 2026
Language
HCL
Stars, last 29 weeks+176
29 Apr 2026: 3,775 stars6 May 2026: 3,781 stars13 May 2026: 3,791 stars20 May 2026: 3,802 stars27 May 2026: 3,806 stars3 Jun 2026: 3,812 stars10 Jun 2026: 3,816 stars17 Jun 2026: 3,825 stars24 Jun 2026: 3,832 stars1 Jul 2026: 3,839 stars8 Jul 2026: 3,846 stars15 Jul 2026: 3,851 stars22 Jul 2026: 3,867 stars29 Jul 2026: 3,875 stars5 Aug 2026: 3,881 stars12 Aug 2026: 3,887 stars19 Aug 2026: 3,894 stars26 Aug 2026: 3,900 stars2 Sept 2026: 3,907 stars9 Sept 2026: 3,910 stars16 Sept 2026: 3,916 stars23 Sept 2026: 3,922 stars30 Sept 2026: 3,925 stars7 Oct 2026: 3,930 stars14 Oct 2026: 3,933 stars21 Oct 2026: 3,935 stars28 Oct 2026: 3,937 stars4 Nov 2026: 3,939 stars11 Nov 2026: 3,945 stars18 Nov 2026: 3,951 stars

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

  1. “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…”

  2. “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…”

  3. “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

Reported, then fixed by a linked change

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
Also in Backends, databases and hosting
RankProjectScore
1bunJavaScript and TypeScript runtime with bundler, test runner and package manager96.8k starscustom license94 out of 100
2coolifySelf-hosted Heroku and Vercel alternative that deploys apps and databases over SSH66.2k stars+3,121 (+4.9%) in 30 daysApache-2.093 out of 100
3traefikHTTP reverse proxy and load balancer that auto-discovers routes from orchestrators65.6k starsMIT93 out of 100
#4appwriteBackend with auth, databases, storage, functions and an MCP server for agents Live demo ↗ (opens in a new tab)58.4k stars+641 (+1.1%) in 30 daysBSD-3-Clause93 out of 100
#5medusaNode.js commerce platform with modular products, carts, orders and payments37.3k starscustom license93 out of 100