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

# Sauvegardes

> Sauvegarder et restaurer une installation auto-hébergée de Notifuse : toutes les bases de données, et la clé secrète.

Notifuse range ses données dans plusieurs bases PostgreSQL : `notifuse_system` (utilisateurs, espaces de travail, paramètres) et une base `notifuse_ws_<workspace id>` par espace de travail (contacts, listes, modèles, newsletters, historique des messages, analyse web). Une sauvegarde doit toutes les contenir, avec la `SECRET_KEY` de l'installation : elle chiffre les identifiants des fournisseurs enregistrés, qui restent illisibles après une restauration faite sans elle.

> [!WARNING]
>
> Une sauvegarde de `notifuse_system` seule restaure une installation qui paraît saine, avec ses utilisateurs et ses espaces de travail, mais sans contacts, newsletters ni messages. Sauvegardez avec elle chaque base `notifuse_ws_…`.

## Sauvegarder

Avec le `compose.yaml` fourni, depuis le dossier qui le contient (remplacez `postgres` par votre `DB_USER` et `notifuse` par votre `DB_PREFIX` si vous les avez changés) :

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

Chaque base arrive dans son propre fichier `.dump`. Copiez ces fichiers, avec la `SECRET_KEY`, ailleurs que sur le serveur. Chaque dump est cohérent pour sa base. Pour une sauvegarde cohérente entre les bases, arrêtez d'abord Notifuse (`docker compose stop api`) puis redémarrez-le ensuite (`docker compose start api`).

`pg_dumpall` ne convient pas : sa restauration supprime et recrée le rôle avec lequel il se connecte, ce qui échoue, et il écrit dans la sauvegarde le hash du mot de passe de ce rôle.

Copier les fichiers du volume de la base pendant que PostgreSQL tourne ne donne pas une sauvegarde restaurable.

## Restaurer

Dans une installation dont la base est vide (un nouveau serveur, ou après `docker compose down -v`), avec la même `SECRET_KEY` dans `.env` et sans `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
```

Restaurez avant que Notifuse ne démarre sur la base vide : un premier démarrage crée une nouvelle base `notifuse_system`, vide. Une fois la restauration réussie, mettez `DB_EXPECT_EXISTING=true` dans `.env` : le jour où Notifuse trouvera une base vide à la place de vos données, il refusera de démarrer.
