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

# Backup

> Fare il backup di un Notifuse self-hosted e ripristinarlo: tutti i database e la chiave segreta.

Notifuse conserva i dati in più database PostgreSQL: `notifuse_system` (utenti, workspace, impostazioni) e un database `notifuse_ws_<workspace id>` per ogni workspace (contatti, liste, template, broadcast, cronologia dei messaggi, web analytics). Un backup deve includerli tutti, insieme alla `SECRET_KEY` con cui gira l'installazione: le credenziali dei provider salvate sono cifrate con questa chiave, e un ripristino senza di essa le rende illeggibili.

> [!WARNING]
>
> Un backup del solo `notifuse_system` ripristina un'installazione che sembra in salute, con i suoi utenti e workspace, ma senza contatti, broadcast né messaggi. Fai il backup anche di tutti i database `notifuse_ws_…`.

## Fare il backup

Con il `compose.yaml` fornito, dalla cartella che lo contiene (sostituisci `postgres` con il tuo `DB_USER` e `notifuse` con il tuo `DB_PREFIX`, se li hai cambiati):

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

Ogni database finisce nel proprio file `.dump`. Copiali, insieme alla `SECRET_KEY`, in un posto diverso dal server. I dump sono coerenti per singolo database; per un backup coerente tra tutti, ferma prima Notifuse (`docker compose stop api`) e riavvialo dopo (`docker compose start api`).

`pg_dumpall` non è adatto: il suo ripristino elimina e ricrea il ruolo con cui si collega, operazione che non riesce, e scrive nel backup l'hash della password del ruolo.

Copiare i file del volume del database mentre PostgreSQL è in funzione non produce un backup ripristinabile.

## Ripristino

In un'installazione con il database vuoto (un nuovo server, o dopo `docker compose down -v`), con la stessa `SECRET_KEY` in `.env` e `DB_EXPECT_EXISTING` non impostata:

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

Esegui il ripristino prima che Notifuse parta sul database vuoto: un primo avvio crea un nuovo `notifuse_system` vuoto. Quando il ripristino funziona, imposta `DB_EXPECT_EXISTING=true` in `.env`, così Notifuse si rifiuta di partire il giorno in cui trova un database vuoto al posto dei tuoi dati.
