jxbit Docs¶

Die interne Dokumentation der jxbit-Infrastruktur — Architektur, Runbooks und Betriebsnotizen an einem Ort.

Was dich hier erwartet¶

Architektur

DNS, Reverse Proxy, Object Storage und Backups als Mermaid-Diagramme — der Gesamtüberblick über die Infrastruktur.

Zur Architektur
Erste Schritte

Wie legt man eine neue Seite an, wie bindet man ein Mermaid-Diagramm ein? Der Einstieg für alle, die hier mitschreiben.

Loslegen
Konventionen

Die verbindlichen Regeln für Docker-Compose-Stacks bleiben im Repo — hier geht es um frei formulierte, längere Doku.

Mehr dazu

Unsere Anwendungen¶

Nextcloud Dateien, Kalender & Kontakte
Authentik Single Sign-On für alle Dienste
Traefik Reverse Proxy & automatisches TLS
Duplicati Verschlüsselte Backups nach S3

Die Bilder oben sind Platzhalter — sobald es lohnende echte Screenshots gibt, einfach die Dateien unter docs/assets/products/ ersetzen.

Abgrenzung¶

Die verbindlichen Konventionen für die Docker-Compose-Stacks selbst (docs/DOCKER-CONVENTIONS.md, docs/ARCHITECTURE.md im Repo-Root) bleiben die primäre Quelle dafür, wie ein Stack aufgebaut sein muss. Diese MkDocs-Instanz ist für frei formulierte, längere Doku gedacht — Runbooks, Architekturskizzen, Betriebsnotizen — nicht als Ersatz dafür.