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

> Faça backup e restaure uma instância auto-hospedada do Notifuse: todos os bancos de dados e a chave secreta.

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.

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

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

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:

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

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.
