Zum Inhalt springen

Self-Hosting

Backups

Ein selbst gehostetes Notifuse sichern und wiederherstellen: alle Datenbanken und den geheimen Schlüssel.

Notifuse speichert seine Daten in mehreren PostgreSQL-Datenbanken: notifuse_system (Benutzer, Arbeitsbereiche, Einstellungen) und eine Datenbank notifuse_ws_<workspace id> pro Arbeitsbereich (Kontakte, Listen, Vorlagen, Kampagnen, Nachrichtenverlauf, Web-Analyse). Ein Backup braucht sie alle und dazu den SECRET_KEY, mit dem die Installation läuft. Die gespeicherten Zugangsdaten der Anbieter sind damit verschlüsselt, und eine Wiederherstellung ohne ihn macht sie unlesbar.

Warnung

Ein Backup von notifuse_system allein stellt eine Installation wieder her, die mit ihren Benutzern und Arbeitsbereichen intakt aussieht, aber keine Kontakte, Kampagnen oder Nachrichten enthält. Sichern Sie jede notifuse_ws_…-Datenbank mit.

Backup erstellen

Mit der mitgelieferten compose.yaml, aus dem Verzeichnis, das sie enthält (ersetzen Sie postgres durch Ihren DB_USER und notifuse durch Ihr DB_PREFIX, falls Sie diese geändert haben):

for db in $(docker compose exec -T postgres psql -U postgres -d postgres -Atc \
    "SELECT datname FROM pg_database WHERE datname = 'notifuse_system' OR datname LIKE 'notifuse\_ws\_%'"); do
  docker compose exec -T postgres pg_dump -U postgres -Fc "$db" > "$db.dump"
done

Jede Datenbank landet in ihrer eigenen .dump-Datei. Kopieren Sie die Dateien zusammen mit dem SECRET_KEY an einen Ort außerhalb des Servers. Jeder Dump ist für sich konsistent. Für ein Backup, das über alle Datenbanken hinweg konsistent ist, stoppen Sie Notifuse vorher (docker compose stop api) und starten es danach wieder (docker compose start api).

pg_dumpall eignet sich nicht: Bei der Wiederherstellung löscht es die Rolle, mit der es verbunden ist, und legt sie neu an, was fehlschlägt. Außerdem schreibt es den Passwort-Hash der Rolle in das Backup.

Die Dateien des Datenbank-Volumes zu kopieren, während PostgreSQL läuft, ergibt kein wiederherstellbares Backup.

Wiederherstellen

In eine Installation mit leerer Datenbank (ein neuer Server oder nach docker compose down -v), mit demselben SECRET_KEY in .env und ohne gesetztes DB_EXPECT_EXISTING:

docker compose up -d postgres
for f in notifuse_*.dump; do
  db=${f%.dump}
  docker compose exec -T postgres createdb -U postgres "$db"
  docker compose exec -T postgres pg_restore -U postgres -d "$db" --exit-on-error < "$f"
done
docker compose up -d

Stellen Sie die Daten wieder her, bevor Notifuse auf der leeren Datenbank startet: Ein erster Start legt eine neue, leere notifuse_system an. Sobald die Wiederherstellung funktioniert hat, setzen Sie DB_EXPECT_EXISTING=true in .env. Findet Notifuse dann eines Tages eine leere Datenbank statt Ihrer Daten, startet es nicht.