I’ve been running a homelab Kubernetes cluster for a while now, and kept meaning to write up how it’s all wired together. This is an overview of what will become a series of posts. I’ll be looking to cover each area of the setup, building it up as we go, including code.

The main tools I’ve used in this build are Proxmox as a hypervisor running the VMs that make up the Kubernetes cluster. Talos Linux, the immutable Linux distro I’ve favoured to build the cluster. ArgoCD, to add the GitOps approach to deploying apps onto my cluster. OpenTofu to deploy parts of the setup and Forgejo to host the Git repos, Container images and run workflows as part of the deployment.