# syself/cluster-api-provider-hetzner

Cluster API Provider Hetzner :rocket: The best way to manage Kubernetes clusters on Hetzner, fully declarative, Kubernetes-native and with self-healing capabilities

Repository: https://github.com/syself/cluster-api-provider-hetzner
Canonical: https://ross.abutalabs.com/products/cluster-api-provider-hetzner
Homepage: https://caph.syself.com
Language: Go
License: Apache-2.0
License Family: permissive
Topics: cluster-api, cluster-api-provider-hetzner, k8s-provider-hetzner, k8s-sig-cluster-lifecycle, k8s-sig-cluster-api, kubernetes, k8s, hetzner, hcloud, devops, operator, bare-metal, cloud-native, go, high-availability, linux
Last push: 2026-09-02T09:30:16+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 96, longevity 100
- inputs: {"age_days": 1834, "days_push": 0, "days_rel": 30, "gap_med": 16, "n_releases_24m": 22}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1131, forks 106 (observed 2026-09-03T02:15:18.360995+00:00)

## What it is
Cluster API Provider Hetzner (CAPH) is a Kubernetes Cluster API provider that enables declarative, Kubernetes-native creation and management of Kubernetes clusters on Hetzner Cloud and Hetzner bare-metal infrastructure. It extends the Kubernetes API with CRDs and offers self-healing, high-availability cluster operations.

## Use cases
- provision kubernetes clusters on hetzner declaratively
- manage hetzner bare metal kubernetes nodes with cluster api
- self-healing kubernetes cluster lifecycle on hcloud
- create hybrid cloud and bare-metal kubernetes clusters
- automate kubernetes cluster upgrades on hetzner
- multi-tenant kubernetes cluster management on hetzner

## When to choose
- You run Kubernetes on Hetzner Cloud or Hetzner Robot bare-metal servers and want Cluster API-based declarative management
- You need self-healing machine health checks and remediation for cluster nodes
- You want a Kubernetes-native, GitOps-friendly alternative to manual cluster provisioning
- You need both cloud VMs and dedicated bare-metal servers in one cluster

## When to avoid
- You use a cloud provider other than Hetzner - pick the matching Cluster API provider
- You want a fully managed Kubernetes service rather than self-managed clusters
- You are not familiar with Cluster API concepts and don't want to learn them
- You need turnkey production add-ons like CNI and node images out of the box - these must be prepared separately

## Facets
- artifact type: infra-config
- maturity: active
- function: infrastructure-as-code, container-orchestration, deployment, cloud, configuration-management
- domain: cloud-computing, infrastructure-as-code, self-hosted
- platform: go, cloud, self-hosted
- tags: cluster-api, kubernetes-operator, hetzner, hcloud, bare-metal, k8s-cluster-lifecycle, declarative-infrastructure, self-healing, devops, containers, kubernetes, linux

## Member repositories
- syself/cluster-api-provider-hetzner (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:18.360995+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:37:59.705887+00:00, confidence not recorded.
  - readme: https://github.com/syself/cluster-api-provider-hetzner (fetched 2026-09-03T02:15:18.360995+00:00, sha 9b9f1d098c40)
  - homepage: https://caph.syself.com (fetched 2026-08-29T12:42:30.422961+00:00, sha 106f12e86978)
  - site_page: https://syself.com/docs/caph/getting-started/quickstart/prerequisites (fetched 2026-08-29T12:42:30.426980+00:00, sha f957c30cdf1e)
  - site_page: https://syself.com/docs/caph/getting-started/quickstart/management-cluster-setup (fetched 2026-08-29T12:42:30.428952+00:00, sha 708216f6980c)
  - site_page: https://syself.com/docs/caph/getting-started/quickstart/creating-a-workload-cluster (fetched 2026-08-29T12:42:30.430801+00:00, sha ea16c18f7edf)
  - site_page: https://syself.com/docs/caph/getting-started/quickstart/next-steps (fetched 2026-08-29T12:42:30.432639+00:00, sha 16c747b75e8f)
  - site_page: https://syself.com/docs/caph/getting-started/preparation (fetched 2026-08-29T12:42:30.434257+00:00, sha 579629ec8a86)
  - site_page: https://syself.com/docs/caph/topics/managing-ssh-keys (fetched 2026-08-29T12:42:30.436835+00:00, sha e6258f0d5e8f)
  - site_page: https://syself.com/docs/caph/topics/HA-setup (fetched 2026-08-29T12:42:30.438619+00:00, sha c0150ee56c29)
  - site_page: https://syself.com/docs/caph/topics/node-image (fetched 2026-08-29T12:42:30.440274+00:00, sha d66272591a9f)
- Data as of 2026-08-30T08:39:29.467469+00:00.