certain/docs/BACKUP.md

Backup & Wiederherstellung

In der App

Einstellungen → Backup & Export:

• Voll-Backup (JSON) — alle eigenen Daten in einem versionierten Format, das sich in der App wieder einspielen lässt (siehe unten): Konten, Kategorien, Buchungen mit allen Feldern, Budget-Vorlage und Monatswerte, Schlagwortregeln, Import-Vorlagen, Dashboard-Layout und die persönlichen Einstellungen.
• Buchungen (CSV/JSON) und Datenübersicht (JSON) — Ansichts-Exporte zum Archivieren und Weiterverarbeiten, etwa in einer Tabellenkalkulation. Referenzen laufen dort über Namen und mehrere Tabellen fehlen: zum Wiederherstellen taugen sie nicht. Die App weist eine solche Datei beim Einspielen ausdrücklich ab, statt halb zu raten.
• Komplettes DB-Backup (nur Admin) — lädt eine konsistente Kopie der gesamten SQLite-Datenbank herunter (alle Nutzer). Erzeugt über die SQLite-Online-Backup-API, also auch bei laufendem Betrieb gefahrlos.
• Systemweites Voll-Backup (JSON) (nur Admin) — dasselbe JSON-Format über alle Benutzer hinweg, inklusive Benutzerkonten. Die Datei enthält Passwort-Hashes und Zwei-Faktor-Geheimnisse und ist wie ein Passwort zu behandeln.

Dateinamen

Alle Downloads heissen certain-finance_<art>_<datum>_<uhrzeit>.<endung>, wobei <art> sagt, worum es geht — das ist der Unterschied, den man im Downloads-Ordner sehen muss:

Datei	Zurückladbar
certain-finance_vollbackup_<benutzer>_2026-08-20_1432.json	ja
certain-finance_vollbackup-system_2026-08-20_1432.json	ja, nur Admin
certain-finance_datenuebersicht_2026-08-20_1432.json	nein
certain-finance_buchungen_2026-08-20_1432.csv / .json	nein
certain-finance_datenbank_2026-08-20_1432.db	ja, aber von Hand (siehe unten)

Den Namen vergibt der Server im Content-Disposition-Kopf; über die Oberfläche und über einen direkten API-Aufruf kommt dieselbe Datei also gleich benannt an.

Wiederherstellen (JSON, in der App)

Einstellungen → Backup zurückladen. Die Datei wird zuerst nur geprüft; die Prüfansicht zeigt, was darin steckt. Geschrieben wird erst nach Bestätigung.

Zwei Vorgehen:

• Ersetzen — die vorhandenen Daten werden gelöscht und durch das Backup ersetzt. Vorher legt der Server automatisch einen Schnappschuss der Datenbank unter /var/lib/certain-finance/backups/pre-restore-*.db an.
• Ergänzen — nichts wird gelöscht, nur Fehlendes kommt hinzu. Konten und Kategorien werden über den Namen abgeglichen, Buchungen über ihren Import-Hash beziehungsweise über Datum, Konto, Betrag und Empfänger. Budget, Regeln und Einstellungen bleiben unangetastet, wenn dazu schon etwas vorhanden ist — halb zusammengeführte Budgets wären nicht sinnvoll deutbar.

Ein systemweites Backup kann nur ein Admin einspielen, und nur ersetzend. Da dabei die Benutzertabelle ausgetauscht wird, enden anschliessend alle Sitzungen und man muss sich neu anmelden. Enthält die Datei keinen Administrator, wird sie abgelehnt — sonst käme danach niemand mehr hinein.

Das Einspielen läuft in einer einzigen Transaktion: entweder geht alles durch, oder es wird nichts geschrieben.

Wiederherstellen (DB-Backup)

Die heruntergeladene .db-Datei ist die komplette Datenbank. Zum Wiederherstellen im LXC:

systemctl stop certain-finance
cp certain-finance-YYYYMMDD-HHMMSS.db /var/lib/certain-finance/app.db
# WAL-/SHM-Reste entfernen, damit die Kopie sauber übernommen wird:
rm -f /var/lib/certain-finance/app.db-wal /var/lib/certain-finance/app.db-shm
chown certain-finance:certain-finance /var/lib/certain-finance/app.db 2>/dev/null || true
systemctl start certain-finance

Datei-Backup (LXC)

Die Datenbank liegt unter /var/lib/certain-finance/app.db.

• Proxmox-Snapshot: vzdump des Containers sichert alles (empfohlen).
• Cron-Kopie: täglich eine konsistente Kopie ablegen und rotieren:

# /etc/cron.daily/certain-finance-backup  (ausführbar machen)
#!/bin/sh
D=/var/lib/certain-finance
mkdir -p "$D/backups"
sqlite3 "$D/app.db" ".backup '$D/backups/app-$(date +\%Y\%m\%d).db'"
# älter als 30 Tage löschen
find "$D/backups" -name 'app-*.db' -mtime +30 -delete

update.sh legt außerdem vor jeder Migration automatisch eine Kopie unter /var/lib/certain-finance/backups/pre-update-*.db an.