/projects/home-kubernetes-cloud
← Back to projects

Home Kubernetes Cloud

active

June 2025

Kubernetes K3s Terraform Ansible ArgoCD Prometheus Grafana HashiCorp Vault KVM
kubernetes homelab infrastructure devops

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.