Hetzner Kube

A CLI tool for provisioning kubernetes clusters on Hetzner Cloud
Alternatives To Hetzner Kube
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Minio41,849201282 hours ago376March 27, 202351agpl-3.0Go
High Performance Object Storage for AI
an hour ago93apache-2.0Lua
🦍 The Cloud-Native API Gateway
a month ago9December 01, 20216Go
Learn and understand Docker&Container technologies, with real DevOps practice!
Dapr22,646573 hours ago510November 28, 2023443apache-2.0Go
Dapr is a portable, event-driven, runtime for building distributed applications across cloud and edge.
Harbor21,271229 hours ago255June 28, 2022590apache-2.0Go
An open source trusted cloud native registry project that stores, signs, and scans content.
Generator Jhipster20,9994,6662092 hours ago273November 02, 2023203apache-2.0TypeScript
JHipster is a development platform to quickly generate, develop, & deploy modern web applications & microservice architectures.
Jina19,378162 hours ago2,437November 20, 202318apache-2.0Python
☁️ Build multimodal AI applications with cloud-native stack
Kuboard Press19,085
3 months ago365JavaScript
Kuboard 是基于 Kubernetes 的微服务管理界面。同时提供 Kubernetes 免费中文教程,入门教程,最新版本的 Kubernetes v1.23.4 安装手册,(k8s install) 在线答疑,持续更新。
Pulumi18,3201327642 hours ago3,923November 17, 20232,029apache-2.0Go
Pulumi - Infrastructure as Code in any programming language. Build infrastructure intuitively on any cloud using familiar languages 🚀
Microservices Demo15,094
2 hours ago53October 31, 202340apache-2.0Python
Sample cloud-first application with 10 microservices showcasing Kubernetes, Istio, and gRPC.
Alternatives To Hetzner Kube
Select To Compare

Alternative Project Comparisons

Build Status Go Report Card Maintainability Gitter chat

hetzner-kube: fast and easy setup of kubernetes clusters on Hetzner Cloud

This project contains a CLI tool to easily provision kubernetes clusters on Hetzner Cloud.

This is my very first tool written in Go.

How to install

Binary releases

Get the binary from releases page

From source

hetzner-kube is written in Go. To install Go please follow the instructions on its homepage.

To get and build hetzner-kube from source run this command:

$ go get -u github.com/xetys/hetzner-kube

The project source will now be in your $GOPATH directory ($GOPATH/src/github.com/xetys/hetzner-kube) and the binary will be in $GOPATH/bin.

If you want to build it yourself later, you can change into the source directory and run go build or go install.

Code completion


To load completion run

source <(hetzner-kube completion bash)

To configure your bash shell to load completions for each session add to your "~/.bashrc" file

# ~/.bashrc or ~/.profile
echo 'source <(hetzner-kube completion bash)\n' >> ~/.bashrc

Or you can add it to your bash_completition.d folder:

# On linux
hetzner-kube completion bash > /etc/bash_completion.d/hetzner-kube
# On OSX with completion installed via brew (`brew install bash-completion`)
hetzner-kube completion bash > /usr/local/etc/bash_completion.d/hetzner-kube


To configure your zsh shell to load completions run following commands:

# On linux
hetzner-kube completion zsh | sudo tee /usr/share/zsh/vendor-completions/_hetzner-kube
# On OSX
hetzner-kube completion zsh | sudo tee /usr/share/zsh/site-functions/_hetzner-kube

Than rebuild autocomplete function with:



In your Hetzner Console generate an API token and

$ hetzner-kube context add my-project

Then you need to add an SSH key:

$ hetzner-kube ssh-key add -n my-key

This assumes, you already have a SSH keypair ~/.ssh/id_rsa and ~/.ssh/id_rsa.pub

And finally, you can create a cluster by running:

$ hetzner-kube cluster create --name my-cluster --ssh-key my-key

This will provision a brand new kubernetes cluster in latest version!

To access the cluster via kubectl, create a config file:

# Write ~/.kube/config (you'll be asked to overwrite if file already exists)
hetzner-kube cluster kubeconfig my-cluster
# Alternatively, create a separate file and point kubectl to it:
#hetzner-kube cluster kubeconfig --print my-cluster > ~/.kube/config-my-cluster
#export KUBECONFIG=~/.kube/config-my-cluster

For a full list of options that can be passed to the cluster create command, see the Cluster Create Guide for more information.


You can build high available clusters with hetzner-kube. Read the High availability Guide for further information.

Custom Options


You can install some addons to your cluster using the cluster addon sub-command. Get a list of addons using:

$ hetzner-kube cluster addon list

contributing new addons

You want to add some cool stuff to hetzner-kube? It's quite easy! Learn how to add new addons in the Developing Addons documentation.

backup & restore (for HA-clusters)

If you are running an external etcd cluster, you can use the etcd management to backup the etcd cluster using

$ hetzner-kube cluster etcd backup my-cluster --snapshot-name my-snapshot

(--snapshot-name is optional)

and restore it using

$ hetzner-kube cluster etcd restore my-cluster --snapshot-name my-snapshot

If you place a different snapshot (with .db file extension) in /root/etcd-snapshots of the first etcd node, you can use the restore command for migration of kubernetes clusters.


After a cluster is once created (nodes creation is enough), you can perform the steps from hetzner-kube cluster create separately.

You can use

$ hetzner-kube cluster phase -h

to only list all available phases.

Cluster creation is a chain of these phases:

  • provision
  • network-setup
  • etcd (if HA)
  • install-masters
  • setup-ha (if HA)
  • install-workers

Some of theses phase have additional options, to run the actual phase differently from the usual cluster creation.

examples for phases

To simply run a phase from cluster creation, you cam run a phase, eg. the etcd phase using:

$ hetzner-kube cluster phase etcd my-cluster

In order to upgrade or migrate a cluster, you might want to keep the etcd data, and run

$ hetzner-kube cluster phase etcd my-cluster --keep-data

and preserve the existing certificates using

$ hetzner-kube cluster phase install-master my-cluster --keep-all-certs

The latter command can be also useful during cluster migration, if you place the existing certs in /etc/kubernetes/pki before running the install-masters phase.


If you like to run some scripts or install some additional packages while provisioning new servers, you can use cloud-init

$ hetzner-kube cluster create --name my-cluster --nodes 3 --ssh-key my-key --cloud-init <PATH-TO-FILE>

An example file to make all nodes ansible ready. The comment on the first line is important:

package_update: true
 - python

Full tutorial

This article guides through a full cluster setup.

Popular Kubernetes Projects
Popular Cloud Computing Projects
Popular Virtualization Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Cloud Computing
Hetzner Cloud