O Notifuse guarda os dados em vários bancos de dados PostgreSQL: notifuse_system (usuários, workspaces e configurações) e um banco notifuse_ws_<workspace id> por workspace (contatos, listas, templates, broadcasts, histórico de mensagens e web analytics). Um backup precisa incluir todos eles e a SECRET_KEY usada pela instalação. Essa chave criptografa as credenciais dos provedores salvas no banco, e uma restauração sem ela torna essas credenciais ilegíveis.
Atenção
Um backup só do notifuse_system restaura uma instalação que parece saudável, com os seus usuários e workspaces, mas sem contatos, broadcasts nem mensagens. Faça backup de todos os bancos notifuse_ws_… junto com ele.
Fazer backup
Com o compose.yaml oficial, a partir do diretório onde ele está (troque postgres pelo seu DB_USER, e notifuse pelo seu DB_PREFIX, se você mudou esses valores):
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
Cada banco de dados é salvo no próprio arquivo .dump. Copie esses arquivos, junto com a SECRET_KEY, para fora do servidor. Cada dump é consistente individualmente; se você precisa de consistência entre todos os bancos, pare o Notifuse antes (docker compose stop api) e suba novamente depois (docker compose start api).
O pg_dumpall não é indicado aqui: na restauração ele tenta apagar e recriar a role usada na conexão, o que falha, e ainda grava o hash da senha dessa role no backup.
Copiar os arquivos do volume do banco enquanto o PostgreSQL está rodando não gera um backup restaurável.
Restaurar
Em uma instalação com o banco de dados vazio (um servidor novo, ou após docker compose down -v), com a mesma SECRET_KEY no .env e sem DB_EXPECT_EXISTING definida:
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
Faça a restauração antes de subir o Notifuse no banco vazio, porque a primeira inicialização cria um notifuse_system novo e vazio. Quando a restauração funcionar, defina DB_EXPECT_EXISTING=true no .env para que o Notifuse se recuse a iniciar se algum dia encontrar um banco vazio no lugar dos seus dados.
