Files
ProxLedger/docs/betrieb/sicherung.md
T
florian.wildeandClaude Opus 5 b6fdd4f64a docs(betrieb): Einrichtung Schritt fuer Schritt dokumentieren (#029)
Vier Anleitungen unter docs/betrieb/: Inbetriebnahme in der richtigen
Reihenfolge, HTTPS mit nginx Proxy Manager sowie netbird als privates Netz,
OIDC mit authentik samt Fehlerbildern, und Sicherung einschliesslich
Zurueckspielen.

Beim Aufschreiben zwei Fehler gefunden, die nur hinter einem Reverse Proxy
auftreten: Die OIDC-Rueckkehradresse uebersah die im Dashboard eingetragene
Adresse, und beim Einloesen des Codes wurde die interne Adresse verwendet -
der Anbieter haette den Tausch abgelehnt.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-19 00:51:16 +02:00

1.4 KiB

Sicherung und Wiederherstellung

Was gesichert werden muss

Sache Wo Ohne sie
Datenbank PostgreSQL alles weg: Hosts, Kunden, Laufzeiten, Rechnungen
APP_SECRET .env alle Sitzungen ungültig, SMTP- und Webhook-Zugangsdaten unlesbar
Hochgeladene PDFs /data/uploads (Docker-Volume) bzw. /opt/proxledger/data/uploads Rechnungsanhänge fehlen

Die Agents brauchen keine Sicherung: Sie registrieren sich neu, und die Zuordnung hängt an der Maschinenkennung, nicht an einem Token.

Sichern

bash deploy/backup.sh          # Datenbank und Uploads

Beim LXC-Weg reicht zusätzlich die gewohnte Proxmox-Sicherung des Containers.

Zurückspielen

# Docker
docker compose down
docker compose up -d postgres
gunzip -c sicherung.sql.gz | docker compose exec -T postgres psql -U proxledger proxledger
docker compose up -d

Danach die .env mit demselben APP_SECRET zurücklegen wie zum Zeitpunkt der Sicherung. Ein anderer Wert lässt die gespeicherten Zugangsdaten unlesbar werden; das Dashboard sagt das beim nächsten Versand deutlich, aber die Werte müssen dann neu eingetragen werden.

Das Wichtigste

Eine Sicherung, die nie zurückgespielt wurde, ist keine Sicherung. Spielen Sie sie einmal in eine leere Testumgebung ein und melden Sie sich dort an. Erst dann wissen Sie, dass Sicherung und APP_SECRET zusammenpassen.