// readme

🏑 Homelab-as-Code (HaCβ„’)

This repository was born out of the need to better manage an ever-growing homelab environment. After starting with a simple single-node Docker Compose setup, the increasing number of services began to make maintenance and updates more challenging.

As the complexity grew, it became clear that a more structured, Infrastructure-as-Code approach was needed to:

  • keep configurations versioned and thus better documented
  • make deployments more consistently repeatable and reliable
  • simplify the process of adding new services without losing track of the overall state
  • enable easier backup and disaster recovery that is centrally managed
  • provide better scalability and resilience beyond a single node

I decided to take this opportunity to properly learn Kubernetes hands-on, embracing the complexity and β€œfeeling the pain” that comes with it rather than just having the theoretical knowledge. This repo serves as both documentation of my setup as well as a real-world learning experience in managing infrastructure that I rely upon as code.

PS: This setup is mature enough to be girlfriend-approved. πŸ˜‰

πŸ”° Overview

At the highest possible level, this repo…