Home Kubernetes Cloud

GitHub · Kubernetes, K3s, Terraform, Ansible, ArgoCD, Prometheus, Grafana, HashiCorp Vault, KVM

A home lab K3s cluster built from scratch on a KVM hypervisor. The goal is to learn Kubernetes by designing and building real infrastructure — because it's fun.

Architecture

The cluster runs on virtual machines provisioned with Terraform using the libvirt API on a KVM hypervisor, enabling fully immutable infrastructure. Post-provisioning configuration is handled by Ansible, which manages system updates and K3s installation.

GitOps & Automation

• ArgoCD for declarative GitOps deployments
• Terraform for immutable VM provisioning
• Ansible for mutable node configuration

Observability & Security

• Prometheus for time-series metrics collection
• Grafana for dashboards and visualization
• HashiCorp Vault for secret management

What I Learned

Running a home lab teaches you things that reading docs never will. Debugging networking issues, managing certificates, and understanding how all the pieces of a Kubernetes cluster fit together has been invaluable.