Homelab / Architektur

Website

Wie root-files.net entsteht — kuratiertes Hugo-Portfolio aus Forgejo, privatem GitHub-Spiegel und Cloudflare Pages.

Diese Seite ist selbst Teil des Labs: root-files.net zeigt das Homelab als kuratiertes Portfolio — nicht als Betriebs-Dashboard und nicht als Spiegel von Wiki oder interner Homepage.

Zweck

  • Portfolio — Architektur, Services, Hardware, Storage, News und ausgewählte Ops-AI-Beispiele
  • Scrubbed — keine internen Hostnamen, keine IPs, keine Vault-Pfade, keine Erreichbarkeits-Hints
  • Bilingual — Deutsch und Englisch aus denselben Kuratierungsquellen

Was hier bewusst fehlt: Runbooks, Admin-UIs und „so mountest du das“.

Delivery-Pipeline

Forgejo ist zuerst die Quelle der Wahrheit für den gesamten Lab-Code (IaC, Docs, CI). Die Portfolio-Site ist nur eine Delivery-Kette davon: Arbeit und SoT liegen im self-hosted Git; von dort spiegelt ein privater Push-Mirror nach GitHub. Cloudflare Pages baut bei Push mit Hugo und veröffentlicht public/ unter root-files.net.

Kein manueller Wrangler-/API-Deploy als Normalweg — Publish folgt dem Git-Push.

flowchart LR
  catalogs[Kuratierte Kataloge]
  forgejo[Forgejo Site-Repo]
  mirror[Privater GitHub-Spiegel]
  pages[Cloudflare Pages Hugo]
  live[root-files.net]
  catalogs --> forgejo --> mirror --> pages --> live
Stufe Rolle
Kuratierte Kataloge Allowlist für Services, News, Ops-Showcases, scrubbed Home-Automation
Forgejo Lab-SoT (IaC, Docs, CI) und Alltag; Site-Repo ist eine davon
GitHub (privat) Offsite-Spiegel / Trigger für Pages
Cloudflare Pages Hugo-Build und CDN für die öffentliche Site

Inhalte

Zwei Wege füttern die Seiten:

  1. Generatoren — Manifeste → Site-data/ (Service-Tiles, News-Journal, Ops-Showcases, HA-Inventar)
  2. Hand-Markdown — Architektur, Konnektivität, Storage, diese Website-Story, Hardware-Produktseiten

Version und Journal: kuratierte Portfolio-Version im Footer, Build-Stempel, Homelab News ab Epoch 1. August 2026.

Prinzipien

  1. Allowlist statt Leak — nur freigegebene Felder und Texte werden öffentlich
  2. Eine Delivery-Kette — Forgejo → Spiegel → Pages; kein paralleler Hand-Deploy
  3. Mehrwert statt Spiegel — Design und Stationen erklären, Betrieb bleibt intern
  4. Nachvollziehbar — News, Version und Deep-Links zeigen, was sich bewegt

Weiter im Kontext: Architektur, Services, News.