Documentation over Homelab
Find a file
2026-07-07 23:50:03 +02:00
docs Documentation: Initial runbooks completed and journal updated 2026-07-07 23:50:03 +02:00
.gitignore Documentation: Big overhaul with many additions of initial templates 2026-07-07 00:55:24 +02:00
LICENSE.md Documentation: Big overhaul with many additions of initial templates 2026-07-07 00:55:24 +02:00
README.md Documentation: Big overhaul with many additions of initial templates 2026-07-07 00:55:24 +02:00

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
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

License

Licensed under the MIT License — free to use, share, and adapt with attribution (keep the copyright notice).