A homelab that runs like production
A homelab cluster run entirely from Git, with nothing configured by hand.
- Client
- Personal platform
- Role
- Operator
Situation
I run my own tools at home, from Git hosting to monitoring. I run that platform the way I run client platforms: from Git, with nothing configured by hand.
What I did
- Created the k3s nodes as virtual machines on Proxmox with Terraform, so the cluster can be rebuilt from code.
- Put every application and the cluster’s own configuration in Git repositories on a self-hosted Gitea.
- Used Kargo to promote each new version from one stage to the next, and Argo CD to keep the cluster in sync with Git. Argo CD reconciles the state on every restart.
- Watched the cluster with Prometheus and Grafana.
Result
Nothing in the cluster is configured by hand: every change is a commit, and Argo CD brings the cluster back to what Git describes after any restart.
Tools
- k3s
- Proxmox
- Terraform
- Gitea
- Argo CD
- Kargo
- Prometheus
- Grafana