Backup & Wiederherstellung

Der App-Container enthält das Werkzeug fahrtenbuch für vollständige Backups (pg_dump, Custom-Format). Ein Backup enthält alle Daten – Nutzer, Fahrzeuge, Fahrten, GPS-Punkte, Einstellungen – sowie den Migrationsstand.

Backup erstellenCopy Anchor Link

docker exec fahrtenbuch-app fahrtenbuch backup
docker exec fahrtenbuch-app fahrtenbuch backup --label before-update

# vorhandene Backups anzeigen
docker exec fahrtenbuch-app fahrtenbuch backups

Backups landen im Volume unter /data/backups. Regelmäßig vom Server wegkopieren:

docker cp fahrtenbuch-app:/data/backups ./backups
# oder als Stream, z. B. im Cronjob
docker exec fahrtenbuch-app fahrtenbuch backup --stdout > fahrtenbuch.dump

WiederherstellenCopy Anchor Link

docker exec -it fahrtenbuch-app fahrtenbuch restore latest
docker exec -it fahrtenbuch-app fahrtenbuch restore fahrtenbuch-db-2026-10-29T10-46-06Z.dump
docker exec -i fahrtenbuch-app fahrtenbuch restore - --yes < fahrtenbuch.dump

docker compose restart app worker

• Vorher wird automatisch ein Sicherheits-Backup (…-vor-restore.dump) erstellt; abschaltbar mit --no-safety-backup.
• Der Restore läuft in einer Transaktion – schlägt etwas fehl, bleibt die Datenbank unverändert.
• Ältere Backups werden direkt auf das aktuelle Schema migriert, neuere abgelehnt (erzwingen mit --force).
• Ohne Terminal (Cron, Skripte) ist --yes erforderlich.
• Redis enthält nur die Job-Queue und ist nicht Teil des Backups.