Über dieses Projekt
Infrastruktur verdient gute Dokumentation.
Diese Seite ist eine persönliche Aufzeichnung jedes Geräts in meinem Homelab. Keine Tutorials. Keine Reviews. Technisches Storytelling über das, was ich wirklich gebaut habe, was darauf läuft und die Entscheidungen hinter jeder Wahl.
Warum ein Homelab dokumentieren?
Homelabs werden schnell komplex. Nach einem Jahr hat man ein Dutzend Dienste, drei Subnetze und eine NAS-Konfiguration, an die man sich nicht mehr vollständig erinnert. Das erste Mal, wenn etwas um 2 Uhr morgens ausfällt, merkt man, dass man es hätte aufschreiben sollen.
Aber die meiste Homelab-Dokumentation ist eine Markdown-Datei in einem privaten Git-Repo, ein Haufen Lesezeichen oder — nichts. Dies ist ein Versuch, es richtig zu machen: Jedes Gerät bekommt eine strukturierte Seite, die die Fragen beantwortet, die ich beim Debuggen stellen werde.
Das Format
Jede Geräteseite ist um fünf Fragen aufgebaut:
-
Was habe ich gebaut?
Konkrete Ergebnisse, keine Absichten. Was tatsächlich läuft.
-
Was läuft darauf?
Alle Dienste und Technologien im Einsatz, mit Versionskontext.
-
Wie ist es aufgebaut?
Die tatsächliche Topologie, Konfigurationsstruktur und Datenflüsse.
-
Warum habe ich X gewählt?
Die Entscheidungen, die das Setup geprägt haben, mit dem Reasoning.
-
Was würde ich ändern?
Ehrliche Retrospektive. Was funktioniert, was nicht, was als Nächstes.
Das Design
Ich wollte eine Dokumentation, die sich so durchdacht anfühlt wie die Hardware selbst. Apples Produktseiten setzen einen Standard für die Vermittlung technischer Details ohne visuelles Rauschen. Diese Seite übernimmt diese Struktur — cinematische Hero-Sections, klare Hierarchie, premium Abstände — und wendet sie auf technische Dokumentation statt Marketing an.
Kein Neon. Keine Farbverläufe um ihrer selbst willen. Nur eine dunkle, fokussierte Oberfläche, die dem Inhalt nicht im Weg steht.
Ein Gerät hinzufügen
Jedes Gerät ist eine MDX-Datei in src/content/devices/.
Das Schema erzwingt Konsistenz: Jedes Gerät hat Name, Status, Rolle, Dienste,
Entscheidungen und Spezifikationen. Der MDX-Body ist frei — für Architektur-Diagramme,
Konfigurationsbeispiele, Tabellen oder alles, was mehr als Aufzählungspunkte braucht.
# Neues Gerät anlegen cp src/content/devices/rpi4-home-assistant.mdx src/content/devices/my-new-device.mdx # Frontmatter bearbeiten # - Name, type, status, headline, role setzen # - services[], stack[], outcomes[] befüllen # - decisions und specs ergänzen # - Fotos nach public/assets/devices/ legen # Die Seite wird automatisch unter /device/my-new-device gebaut