🏠 Homelab Infrastructure¶
Welcome to the complete infrastructure documentation for this homelab. This site covers all Kubernetes applications, infrastructure components, and deployment strategies.
Quick Navigation¶
Explore user-facing applications deployed on the cluster.
- User Applications — Pi-hole, Immich, Bookstack, and more
- Infrastructure Services — Traefik, Prometheus, Loki, cert-manager
- Cluster Components — Flux, k3s config
Learn how to build, deploy, and manage infrastructure.
- Building Images — Docker & container builds
- Kubernetes Manifests — Kustomize & Helm releases
- MkDocs Site — This documentation site
Understand the infrastructure design and patterns.
- System Architecture — Overview & topology
- Development Tools — Local setup & generators
Getting Started¶
New here?
Start with the Quick Start Guide to understand the repository structure and get up and running.
# Preview docs locally
python3 -m pip install -r requirements.txt
mkdocs serve
Then open http://localhost:8000 in your browser.
Key Features¶
All applications run in Kubernetes (k3s). Manifests are version-controlled and reproducible.
Flux monitors the repository for changes and automatically reconciles the cluster state.
Prometheus + Loki + Grafana provide metrics, logs, and insights into system health.
TLS certificates via cert-manager, DNS filtering with Pi-hole, and authentication layers.
Repository Structure¶
.
├── apps/ # User applications (Forgejo, Immich, etc.)
├── infrastructure/ # Infrastructure & cluster services
├── clusters/ # Cluster configuration & Flux setup
├── docs/ # This documentation
└── tools/ # Helper scripts & generators
Finding what you need?
Use the search bar (top right) or navigate by category using the tabs above.
Support & Links¶
- Repository: fit.serlo.lu/monty/homelab
- This Site: doc.serlo.lu