> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

> [!WARNING]
>
> 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):

```bash
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`:

```bash
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.
