Zum Inhalt

35 — Git, Gitea & Dokumentation: Übersicht

Stand: 2026-03-31

Was ist was?

Begriff Was ist das? Wo läuft es?
Git Versionskontrolle — speichert Dateien + alle Änderungen VPS, Pi5, Mac (lokal)
Gitea Git-Server — das zentrale Original, von dem alle Klone lesen/schreiben VPS (Container, Port 3003)
Klon Lokale Kopie eines Repos — wird automatisch alle 5 Min synchronisiert VPS, Pi5, Mac
Claude Code KI-Assistent, erstellt und bearbeitet Dateien in den Klonen VPS, Pi5, Mac (via SSH)

Wie hängt alles zusammen?

                    ┌─────────────────────┐
                    │  Gitea (auf VPS)     │
                    │  = das Original      │
                    │  Port 3003           │
                    │  extern: gitea-      │
                    │  anknorr.ddnss.de    │
                    └──┬──────┬──────┬─────┘
                       │      │      │
                  auto-sync (alle 5 Min)
                  pull + commit + push
                       │      │      │
              ┌────────┘      │      └────────┐
              ▼               ▼               ▼
        ~/dokumentation/ ~/dokumentation/ ~/dokumentation/
          auf VPS           auf Pi5          auf Mac
          (Klon)            (Klon)           (Klon)

Gitea ist das führende System. Die drei Verzeichnisse auf VPS, Pi5 und Mac sind Klone. Alle Änderungen gehen über Gitea.

Repos

Repo Inhalt Klone auf
dokumentation Alle Doku-Dateien (01–70+), 12 Ordner, 78+ Markdown-Dateien VPS, Pi5, Mac
claude-sync CLAUDE.md, Memory-Dateien VPS, Pi5, Mac

Weitere Repos in Gitea (ohne automatischen Sync auf alle Systeme): - homeassistant-config — HA Config (ohne Secrets) - terminservice — Kalender-Sync, Web App - sungrow-docs — Sungrow/PV Dokumentation - diagramme — Draw.io Diagramme - claude-knowledge — alt, wird nicht mehr genutzt

Zugriff auf die Dokumentation

Mac (Hauptarbeitsplatz)

Direkt im Finder: ~/dokumentation/ öffnen — das sind echte lokale Dateien. Markdown-Dateien mit jeder App öffnen (iA Writer, Drafts, TextEdit, VS Code, ...).

Änderungen werden automatisch alle 5 Minuten nach Gitea synchronisiert. Du musst nichts manuell tun — einfach Datei editieren und speichern.

iPad

Drei Optionen, je nach Bedarf:

Methode Wofür Einrichtung
Gitea Web (empfohlen) Lesen, gelegentlich editieren Safari → https://gitea-anknorr.ddnss.de
ShellFish Dateien auf VPS/Pi5 die NICHT im Repo sind SSH-Verbindung, erscheint in Dateien-App
Working Copy (25€) Vollständiger Git-Klon aufs iPad App Store, Repo klonen

Für den normalen Gebrauch reicht Gitea Web völlig.

Gitea Web (alle Geräte)

Extern: https://gitea-anknorr.ddnss.de Intern: http://localhost:3003 (VPS) oder via WireGuard

Login User Passwort Rechte
Admin ak (in 1Password "Gitea (VPS)") lesen + schreiben
Lese-Zugang leser LeseZugang2026! nur lesen, 3 Repos

Funktionen: Dateien lesen (Markdown gerendert), editieren, Versionshistorie, Diffs zwischen Versionen.

Sync-Mechanismus

Auf allen drei Systemen läuft ein Timer (systemd auf VPS/Pi5, LaunchAgent auf Mac) der alle 5 Minuten:

  1. git pull — neue Änderungen von Gitea holen
  2. git add -A — lokale Änderungen vormerken
  3. git commit — lokale Änderungen speichern
  4. git push — Änderungen nach Gitea schieben

Script: ~/dokumentation/sync.sh (bzw. ~/claude-sync/sync.sh)

Was passiert wenn Claude eine Datei ändert?

  1. Claude editiert die Datei im Klon (z.B. auf dem VPS)
  2. Claude macht git commit + git push → sofort in Gitea
  3. Pi5 und Mac ziehen die Änderung beim nächsten Sync (max. 5 Min)

Was passiert wenn du eine Datei auf dem Mac editierst?

  1. Du editierst die Datei in ~/dokumentation/
  2. Der Sync-Timer macht automatisch commit + push → nach Gitea
  3. VPS und Pi5 ziehen die Änderung beim nächsten Sync

Andere Zugriffswege (nicht für Dokumentation)

Methode Wofür Ziel
ShellFish (Mac + iPad) SSH-Terminal, Dateien auf VPS/Pi5 die nicht in Git sind (Docker-Configs, Logs) VPS, Pi5
Finder → "Mit Server verbinden" (nur Mac) SMB-Zugriff auf Pi5 (schneller als SSH, nur im LAN) smb://192.168.178.199

Diese Wege braucht man nicht für die Dokumentation — nur für Administration und Dateien außerhalb der Repos.

Claude Code: Wissensmanagement

CLAUDE.md — Die Wissensbasis

Was: Markdown-Datei mit allen Fakten über Systeme, Netzwerk, Konventionen, offene Aufgaben. Wo: ~/.claude/CLAUDE.md (Symlink → ~/claude-sync/CLAUDE.md) Sync: Automatisch über Repo claude-sync (alle 5 Min) Geladen: Automatisch bei jedem Start einer Claude Code Sitzung.

Memory — Das Langzeitgedächtnis

Was: Einzelne Dateien zu bestimmten Themen (Netzwerk, Salto, PV, Passwörter, ...). Wo: ~/.claude/projects/-home-ak/memory/ (Symlink → ~/claude-sync/...) Index: MEMORY.md — wird bei jedem Sitzungsstart geladen.

Typ Zweck Beispiel
user Wer ist der Nutzer, Vorlieben "bevorzugt kompakte Antworten"
feedback Verhaltensregeln "Kein sudo wenn nicht nötig"
project Laufende Projekte, Entscheidungen "rpp1 Migration Phase 1+2 erledigt"
reference Wo findet man externe Infos "Bear-DB auf Mac unter ~/Library/..."

Was wurde abgelöst? (Historie)

Alt Neu Wann
Gitea auf Pi5 Gitea auf VPS 28.03.2026
Bear-Sync (LaunchAgent → Bear) Finder + Gitea Web 30.03.2026
~/Repos/ auf Mac (alte Klone) gelöscht, nur ~/dokumentation/ 31.03.2026
BookStack (Wiki) Git + Markdown Anfang 2026
Working Copy (iPad) Gitea Web März 2026
scp/rsync Sync Git push/pull Anfang 2026

Zusammenfassung

Gitea auf dem VPS ist das Original. Drei Klone (VPS, Pi5, Mac) synchronisieren automatisch alle 5 Minuten. Auf dem Mac: einfach im Finder ~/dokumentation/ öffnen. Auf dem iPad: Gitea Web im Browser. Claude arbeitet in den Klonen und pusht Änderungen sofort nach Gitea.