Backups und Restore
Wichtig sind das PostgreSQL-Volume, das SeaweedFS-Volume und deine .env. Ein Skript kopiert alle drei, testet die Kopie in einer Wegwerf-Datenbank und meldet an Admin > Status.
Backup erstellen
Starte die Skripte aus dem Ordner mit docker-compose.yml und .env (so kommst du an die Skripte):
BACKUP_DIR=/srv/backups/mnema ./scripts/backup.sh
Das schreibt Datenbank, Medien, env und die Compose-Datei nach BACKUP_DIR/<timestamp>/, mit einem Manifest, SHA-256-Prüfsummen und einer Markierung COMPLETE, die nach der Validierung geschrieben wird.
Standardmäßig ist das Backup kalt: Das Skript stoppt für den Snapshot erst die App und dann SeaweedFS, laufende Gespräche brechen für diesen Moment also ab, und es startet danach nur die Dienste wieder, die vorher liefen. Ein Backup enthält die .env mit allen Geheimnissen: Bewahre es sicher auf, kopiere es vom Rechner weg und verschlüssele Kopien außer Haus.
Der Restore-Test läuft jedes Mal
Sobald die Dienste wieder laufen, importiert backup.sh den Dump in einen Wegwerf-PostgreSQL-Container ohne Netzzugang und entfernt ihn danach wieder; die Live-Datenbank wird nie angefasst. Ein fehlgeschlagener Test behält das Backup, räumt nichts auf und lässt das Skript mit einem Fehlercode enden, sodass Cron es meldet. RESTORE_TEST=0 überspringt den Test (nicht empfohlen).
Danach schreibt es backup-status/status.json neben das Deployment. Die mitgelieferte Compose-Datei bindet diesen Ordner in die App ein, sodass Admin > Status > Backups & disaster recovery Alter und Größe des letzten Backups und des Restore-Tests zeigt und warnt, wenn das Backup älter als 36 Stunden ist oder der Test fehlgeschlagen ist.
Jede Nacht
Ein Cronjob auf dem Host, zum Beispiel um 03:30:
30 3 * * * cd /path/to/mnema-talk && BACKUP_DIR=/srv/backups/mnema ./scripts/backup.sh
Die Aufbewahrung löscht alte Backups nur, wenn sie validiert und vollständig sind und der Lauf erfolgreich war.
Online-Backups: ohne Ausfallzeit
BACKUP_MODE=online BACKUP_DIR=/srv/backups/mnema ./scripts/backup.sh
Die App läuft weiter: Nachrichten, Anwesenheit und Gespräche gehen weiter. Nur der Dateispeicher pausiert, während sein Volume kopiert wird; Uploads und Downloads warten so lange (auf einem kleinen Server Sekunden). Das Skript setzt eine Sperre, damit Jobs, die Dateien löschen, warten, friert den Speicher ein, legt einen Datenbank-Snapshot fest, kopiert den Speicher und gibt ihn wieder frei und sichert dann genau diesen Snapshot. Der Restore-Test liest jede Datei, auf die die Datenbank verweist, damit ist jedes Online-Backup als vollständig bewiesen.
Verschlüsselte Backups
Mit einem oder mehreren öffentlichen age-Schlüsseln in BACKUP_AGE_RECIPIENT (und age auf dem Host) wird das fertige, getestete Backup in eine einzelne Datei <timestamp>.tar.age gepackt und der unverschlüsselte Ordner entfernt. Halte den privaten Schlüssel vom Server fern:
age-keygen -o mnema-backup.keyBACKUP_AGE_RECIPIENT=age1... BACKUP_DIR=/srv/backups/mnema ./scripts/backup.sh
Führ age-keygen auf einem anderen Rechner aus; es gibt den öffentlichen Schlüssel aus.
Wiederherstellen
Prüf ein Backup erst und spiel es dann ein:
./scripts/restore.sh /srv/backups/mnema/20261005-033000 --verify./scripts/restore.sh /srv/backups/mnema/20261005-033000
--verify importiert in einen Wegwerf-PostgreSQL-Container und prüft die Archive, ohne etwas Laufendes anzufassen. Der normale Restore fragt zuerst nach (--yes überspringt die Frage), stoppt die Schreiber, ersetzt Datenbank und Medien und startet die Dienste wieder, die liefen. Bei einem verschlüsselten Backup gibst du den Schlüssel nur für den Restore an: BACKUP_AGE_IDENTITY=/root/mnema-backup.key ./scripts/restore.sh <file>.tar.age --verify.
Der Restore behält die aktuelle .env und die Compose-Dateien. Vergleich sie von Hand mit der gesicherten env; wer blind Datenbank-Zugangsdaten oder Speicher-Endpunkte ersetzt, kann sich von den wiederhergestellten Daten aussperren.
Umzug auf einen anderen Rechner
Ein Backup und ein Restore: Richte den neuen Rechner mit derselben .env ein, starte PostgreSQL und SeaweedFS, spiel das Backup ein, starte die App und stell dann den DNS-Eintrag um. Alle Optionen, der Online-Modus im Detail und der Wechsel von PostgreSQL zwischen Hauptversionen: Backups and restore.