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

# Copias de seguridad

> Haz una copia de seguridad de un Notifuse autoalojado y restáurala: todas las bases de datos y la clave secreta.

Notifuse guarda sus datos en varias bases de datos PostgreSQL: `notifuse_system` (usuarios, espacios de trabajo, configuración) y una base `notifuse_ws_<workspace id>` por cada espacio de trabajo (contactos, listas, plantillas, envíos masivos, historial de mensajes, analítica web). Una copia de seguridad necesita todas ellas y la `SECRET_KEY` con la que funciona la instalación. Las credenciales de proveedores guardadas están cifradas con esa clave, y una restauración sin ella las deja ilegibles.

> [!WARNING]
>
> Una copia de seguridad de `notifuse_system` sola restaura una instalación que parece sana, con sus usuarios y espacios de trabajo, pero sin contactos, envíos masivos ni mensajes. Incluye en la copia todas las bases `notifuse_ws_…`.

## Hacer la copia de seguridad

Con el `compose.yaml` proporcionado, desde el directorio que lo contiene (sustituye `postgres` por tu `DB_USER` y `notifuse` por tu `DB_PREFIX` si los cambiaste):

```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 base de datos queda en su propio archivo `.dump`. Cópialos, junto con `SECRET_KEY`, a otro lugar que no sea el servidor. Cada volcado es coherente para su base de datos. Para una copia coherente entre todas, detén Notifuse antes (`docker compose stop api`) y vuelve a iniciarlo después (`docker compose start api`).

`pg_dumpall` no sirve aquí: su restauración elimina y vuelve a crear el rol con el que se conecta, lo que falla, y además escribe el hash de la contraseña del rol en la copia.

Copiar los archivos del volumen de la base de datos mientras PostgreSQL está en marcha no da una copia que se pueda restaurar.

## Restaurar

En una instalación cuya base de datos está vacía (un servidor nuevo, o después de `docker compose down -v`), con la misma `SECRET_KEY` en `.env` y sin definir `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
```

Restaura antes de que Notifuse arranque sobre la base vacía, porque un primer arranque crea un `notifuse_system` nuevo y vacío. Cuando la restauración funcione, define `DB_EXPECT_EXISTING=true` en `.env`. Así Notifuse se negará a arrancar el día que encuentre una base de datos vacía en lugar de tus datos.
