Documentation over Homelab
| docs | ||
| .gitignore | ||
| LICENSE.md | ||
| README.md | ||
mymh.dev — Hybrid Homelab & GitOps Platform
Author: Niklas Häll (mymh) — [TODO: Forgejo public profile URL] Home repo: [TODO: Forgejo repo URL]
Self-hosted, EU-sovereign hybrid infrastructure for a personal web platform. On-prem source of truth (Forgejo + PostgreSQL) drives GitOps-managed Kubernetes clusters in the cloud (Talos, vCluster, ArgoCD). Built as a portfolio project to demonstrate DevSecOps, multi-cluster Kubernetes, observability (incl. DORA metrics), and controlled failover.
Core values
- EU sovereignty — EU-based infrastructure and services only
- Data security — least privilege, encryption in transit, minimal public exposure
- GitOps & DevSecOps — everything declarative, Git as control plane
- Open source first — CNCF/community-governed tooling, LTS versions preferred
- Energy-conscious design — power draw factors into technical choices
Repository structure
homelab-docs/
├─ docs/ # All documentation
│ ├─ adr/ # Architecture Decision Records (+ index)
│ ├─ project_breakdown/ # Vision, values & goals, architecture overview
│ ├─ journal/ # Date/phase-driven progression log
│ ├─ bugs_and_improvements/ # Known bugs and improvement ideas
│ └─ runbooks/ # Operational procedures
├─ .gitignore
├─ LICENSE # MIT
└─ README.md # This file
Related repositories
| Repo | Purpose |
|---|---|
| homelab-docs | Documentation, ADRs, journal (this repo) |
| homelab-iac | On-prem machine provisioning |
| cluster-config | Talos machine configs & cluster bootstrap |
| gitops | ArgoCD app-of-apps: vClusters, platform, app manifests |
| chaos-scripts | Break/verify/fix training scenarios |
(Repos are created as they get content — see ADR-002.)
Documentation entry points
- ADR index — why decisions were made
- Journal — what happened, when
- Project breakdown — vision and goals
License
Licensed under the MIT License — free to use, share, and adapt with attribution (keep the copyright notice).