ghik/kubernetes-the-harder-way

A guide to setting up a production-like Kubernetes cluster on a local machine

Shell

1,007

247 commits

updated Mar 29, 2026

See the code

README

Kubernetes the Harder Way

A guide to setting up a production-like Kubernetes cluster on a local machine.

It is written in the spirit, and with inspirations from Kelsey Hightower's Kubernetes the Hard Way, and may be considered its lengthier, extended version, optimized for a local deployment.

This repository contains the guide itself, as well as scripts and configuration files that serve as a reference result of completing the guide. The guide comes in two versions: for macOS/ARM64 (Apple Silicon) and for Linux/AMD64 (Ubuntu). The scripts work on both platforms (there are no separate versions).

License

This guide follows the license of the original Kubernetes the Hard Way: Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License

Chapters

[ macOS/ARM64 | Linux/AMD64 ]

  1. Introduction
  2. Learning How to Run VMs with QEMU
  3. Preparing Environment for a VM Cluster
  4. Launching the VM Cluster
  5. Bootstrapping Kubernetes Security
  6. Installing Kubernetes Control Plane
  7. Spinning up Worker Nodes
  8. Installing Essential Cluster Services
  9. Simplifying Network Setup with Cilium (optional)
  10. TLDR Version of the Guide (auxiliary)
kubernetes
linux
macos
qemu

ghik/kubernetes-the-harder-way

A guide to setting up a production-like Kubernetes cluster on a local machine

Shell

1,007

247 commits

updated Mar 29, 2026

See the code

README

Kubernetes the Harder Way

A guide to setting up a production-like Kubernetes cluster on a local machine.

It is written in the spirit, and with inspirations from Kelsey Hightower's Kubernetes the Hard Way, and may be considered its lengthier, extended version, optimized for a local deployment.

This repository contains the guide itself, as well as scripts and configuration files that serve as a reference result of completing the guide. The guide comes in two versions: for macOS/ARM64 (Apple Silicon) and for Linux/AMD64 (Ubuntu). The scripts work on both platforms (there are no separate versions).

License

This guide follows the license of the original Kubernetes the Hard Way: Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License

Chapters

[ macOS/ARM64 | Linux/AMD64 ]

  1. Introduction
  2. Learning How to Run VMs with QEMU
  3. Preparing Environment for a VM Cluster
  4. Launching the VM Cluster
  5. Bootstrapping Kubernetes Security
  6. Installing Kubernetes Control Plane
  7. Spinning up Worker Nodes
  8. Installing Essential Cluster Services
  9. Simplifying Network Setup with Cilium (optional)
  10. TLDR Version of the Guide (auxiliary)
kubernetes
linux
macos
qemu

Significant stargazers

Vladimir Sitnikov

504 followers · starred Sep 2025

Ricardo Catalinas Jiménez

107 followers · starred Sep 2024

Dmitry Savintsev

95 followers · starred Jun 2024

K V Varun Krishnan

107 followers · starred Nov 2025