Welcome to My Kubernetes Homelab Journey!
Welcome! This blog follows my journey building a modern, Kubernetes-based homelab. I’ll share lessons, challenges, and discoveries as I create and manage an open-source, enterprise-inspired platform at home.
Are you curious if this journey is for you? Use the checklist below:
Why This Homelab?
This project is about learning and building a robust, automated lab environment at home. Here are the principles and tools at its core:
- Kubernetes as the Core: Using Talos OS for a minimal, API-driven Kubernetes setup.
- Infrastructure as Code (IaC): OpenTofu manages virtual machines on Proxmox.
- GitOps First: ArgoCD handles all cluster changes using Git as the source of truth.
- Declarative Configuration: Kustomize makes complex Kubernetes manifests easier to manage.
- Full Automation: CI/CD with GitHub Actions, automatic SSL with Cert-Manager, and more.
Goal: A system that’s reliable, easy to audit, and fun to operate.
What You'll Find on This Blog
This space documents each stage of the homelab build.
You'll see:
- Deep Dives: In-depth reviews of tech like Cilium networking, Longhorn storage, or Authentik for authentication.
- Step-by-Step Tutorials: Guides for new services or solving tricky problems.
- Troubleshooting & Learnings: What broke, and how I fixed it.
- New Features: Fresh apps and major upgrades as they happen.
- Milestones: Project status, refactors, and documentation highlights.
Take a Look at the Project
Everything is open source: GitHub repository.
Explore:
/k8s/
: Kubernetes manifests—managed by ArgoCD./tofu/
: OpenTofu code for provisioning Talos clusters./website/docs/
: Setup and management documentation.
Want to Get Involved?
This is a personal project, but feedback and discussion are welcome! If you spot an issue or have an idea, open an issue on GitHub.
Follow along for updates and real-world lessons as the homelab grows. Thanks for reading — and welcome!