So funktioniert unsere Dokumentation

Stand: 2026-03-19

Worum geht es?

Wir haben ein System aufgebaut, mit dem technisches Wissen an einem zentralen Ort gesammelt, gepflegt und von überall abgerufen werden kann — vom Schreibtisch, vom iPad unterwegs oder vom Handy.

Diese Seite erklärt, welche Werkzeuge dabei zum Einsatz kommen und wie sie zusammenspielen.

Die Werkzeuge im Überblick

Git + Gitea — Versionierung und zentraler Speicher

Git merkt sich jede Änderung an einer Datei — wer hat wann was geändert. Man kann jederzeit zu einer früheren Version zurückkehren.

Gitea ist unser eigener Git-Server auf dem Raspberry Pi. Es speichert die Repositories und bietet eine Web-Oberfläche: http://192.168.178.199:3003

4 Repositories:

Repo	Inhalt
dokumentation	Alle Doku-Dateien (01–59)
claude-knowledge	CLAUDE.md, Memory, sync.sh
homeassistant-config	Home Assistant Konfiguration
terminservice	Terminservice Bestattungen

Bear — Doku lesen auf Mac und iPad

Was ist das? Markdown-Notiz-App für Mac und iPad mit automatischem iCloud-Sync.

Wofür nutzen wir es? - Dokumentation lesen (Mac + iPad) - Volltextsuche über alle Doku-Dateien - Tags bilden die Ordnerstruktur ab (#Doku/05_netzwerk, #Doku/20_salto usw.)

Wie hängt es zusammen? - Mac: Ein LaunchAgent importiert alle 60 Minuten geänderte Doku-Dateien aus dem Git-Repo in Bear - iPad: Bear synct automatisch per iCloud — nur lesen

Wichtig: Bear ist nur zum Lesen. Änderungen an der Dokumentation werden ausschließlich über Claude Code (auf Mac oder Pi) gemacht und per Git versioniert.

Secure ShellFish — Terminal auf Mac + iOS

Was ist das? Terminal-Emulator für macOS mit tmux-Controlmode.

Wofür nutzen wir es? - SSH zu raspip5, rpp1, SaltoServer - Claude Code Sessions (über SSH + tmux) - Profile pro Host mit Farbcodierung

Besonderheit: Spracheingabe direkt integriert, einheitliches Terminal auf Mac + iPad + iPhone. Ersetzt iTerm2 + SuperWhisper seit 22.03.2026.

WebSSH — Terminal auf dem iPad

Was ist das? SSH-Client für das iPad.

Wofür nutzen wir es? - Administration unterwegs (SSH zu raspip5) - Einfacher Zugriff ohne zusätzliche App-Konfiguration

Markdown — die Schreibweise

Markdown ist eine einfache Art, Text zu formatieren. Man schreibt normalen Text mit ein paar Sonderzeichen.

Was man tippt	Was daraus wird
`# Überschrift`	Eine große Überschrift
`fett`	fett
`- Punkt 1`	• Punkt 1
`Code`	`Code` (technischer Begriff)

Warum Markdown? - Funktioniert überall (Git, Bear, Claude Code) - Keine Abhängigkeit von bestimmter Software - Die Dateien sind normaler Text — lesbar auch ohne spezielle App - Zukunftssicher: Selbst in 20 Jahren noch lesbar

Wie alles zusammenspielt

Schritt	Was passiert
Claude Code schreibt	Dateien werden erstellt/bearbeitet auf dem Pi oder Mac
Git versioniert	Jede Änderung wird gespeichert
Git push/pull ↔ Gitea	Bidirektionaler Sync zwischen Pi und Mac
LaunchAgent → Bear	Mac importiert geänderte Dateien alle 60 Min in Bear
Bear iCloud-Sync	iPad erhält Doku-Notizen automatisch

Mac — automatischer Sync: - LaunchAgent läuft alle 60 Minuten: pull von Gitea, geänderte Dateien in Bear importieren - Oder manuell im Terminal anstoßen

Pi — automatischer Sync: - sync.sh läuft täglich um 03:00: pull + commit + push nach Gitea

Was kommt wohin?

Ich will...	Dann nutze ich...
Dokumentation lesen (Mac)	Bear → Tag `Doku`
Dokumentation lesen (iPad)	Bear → Tag `Doku` (iCloud-Sync)
Dokumentation schreiben/bearbeiten	Claude Code auf Mac oder Pi → Git
Änderungen nachvollziehen (wer, wann, was)	Gitea im Browser oder Claude Code fragen
Schnell etwas notieren (Idee, Aufgabe)	Bear (persönliche Notizen, eigene Tags)
Ein Passwort oder API-Key speichern	1Password
SSH-Zugriff (Mac+iOS)	Secure ShellFish
SSH-Zugriff (iPad)	WebSSH

Begriffe kurz erklärt

Begriff	Bedeutung
Repository (Repo)	Ein Ordner mit Dateien, deren Versionsgeschichte Git verwaltet
Commit	Ein gespeicherter Änderungsstand mit Beschreibung
Push	Änderungen vom eigenen Gerät zum Server schicken
Pull	Änderungen vom Server auf das eigene Gerät holen
Markdown (.md)	Textformat mit einfacher Formatierung
Sync	Abgleich zwischen zwei Orten, damit beide denselben Stand haben
Tag	Schlagwort in Bear zur Kategorisierung (z.B. `#Doku/05_netzwerk`)

Wichtige Adressen

Dienst	Adresse	Zugang
Gitea	http://192.168.178.199:3003	Nur im Heimnetz
Home Assistant	http://192.168.178.199:8123	Heimnetz + Nabu Casa
HA Remote	https://rwfdxpopkswj4lbfwntl6hgtc3az7i0p.ui.nabu.casa	Von überall
Grafana	https://anknorr.ddnss.de	Von überall

Alle Zugangsdaten sind in 1Password im Vault CK gespeichert.

Was wurde abgelöst?

Alt	Neu	Warum
BookStack (Wiki)	Git + Bear	Doppelte Datenhaltung vermieden
iA Writer + iCloud-rsync	Bear + iCloud-Sync	Nativer Sync, bessere Suche, keine rsync-Hacks
Working Copy (iPad)	Bear (iPad)	Einfacher, kein Extra-Tool