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.
Attenzione
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):
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:
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.
