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

# Actualizar PostgreSQL

> Cómo compose.yaml pasa una instalación de PostgreSQL 17 a 18, cómo comprobarlo y cómo volver atrás.

Desde la versión 44.0, `compose.yaml` ejecuta PostgreSQL 18. Una instalación hecha con un `compose.yaml` anterior ejecuta PostgreSQL 17, y su primer `docker compose up -d` con 44.0 la actualiza por sí solo. Notifuse sigue funcionando con PostgreSQL 17 (y rechaza un servidor más antiguo), así que nada te obliga a cambiar: consulta [Quedarse en PostgreSQL 17](#staying-on-postgresql-17).

Una instalación con una base de datos externa (`DB_HOST` apuntando a un PostgreSQL gestionado) no se ve afectada: Notifuse solo se conecta a ella.

## Qué hace `docker compose up -d`

1. Compose detiene Notifuse y PostgreSQL 17.
2. El servicio `pg-upgrade` copia los datos de PostgreSQL 17 en el volumen `postgres-upgrade-backup`, sustituyendo cualquier copia anterior. Si el disco de ese volumen tiene menos espacio libre que los datos más un 10 %, se detiene sin cambiar nada y el stack no arranca: `docker compose logs pg-upgrade` indica cuánto espacio necesita. Libera espacio y vuelve a ejecutar `docker compose up -d`.
3. Actualiza los datos a PostgreSQL 18 en el mismo lugar, con [pgautoupgrade](https://github.com/pgautoupgrade/docker-pgautoupgrade) (`pg_upgrade --link`).
4. PostgreSQL 18 arranca sobre los datos actualizados, y luego Notifuse.

Mientras tanto, Notifuse no está disponible. La duración depende más del número de espacios de trabajo que del volumen de datos, porque cada espacio de trabajo tiene su propia base de datos: segundos para unos pocos espacios de trabajo, minutos para cientos. Síguela con `docker compose logs -f pg-upgrade`.

Cada `docker compose up -d` posterior encuentra los datos en 18 y no hace nada.

Si la actualización se interrumpe a medias (un error, o el servidor que se cae), el stack no arranca; el siguiente `docker compose up -d` restituye la copia y vuelve a empezar la actualización. `docker compose logs pg-upgrade` muestra el error del intento fallido.

> [!WARNING]
>
> La copia es una forma de volver atrás en el mismo disco, no una copia de seguridad. [Haz una copia de seguridad](https://www.notifuse.com/es/docs/self-hosting/backups.md) antes de actualizar y guarda `SECRET_KEY` junto a ella.

## Antes de actualizar

- **Haz una copia de seguridad** de todas las bases de datos, como explica [Copias de seguridad](https://www.notifuse.com/es/docs/self-hosting/backups.md).

- **Comprueba el espacio libre**: la copia necesita tanto como ocupan los datos. Con el stack funcionando en 17:

  ```bash
  docker compose exec postgres du -sh /var/lib/postgresql/data
  df -h /var/lib/docker
  ```

- **Define `DB_EXPECT_EXISTING=true`** en `.env`. Si algo saliera mal y Notifuse encontrara una base de datos vacía, se detendría en lugar de iniciar en ella una nueva instalación.

## Comprobar el resultado

```bash
docker compose logs pg-upgrade | grep -i copy      # "Copying the PostgreSQL 17 data ..." then "Copy done"
docker compose exec postgres psql -U postgres -d postgres -Atc "SELECT version()"    # PostgreSQL 18.x
docker compose exec postgres psql -U postgres -d postgres -Atc "SELECT datname FROM pg_database ORDER BY 1"
```

El último comando lista `notifuse_system` y una base de datos `notifuse_ws_…` por espacio de trabajo (sustituye `postgres` por tu `DB_USER` si lo cambiaste). Después inicia sesión y abre tus espacios de trabajo.

## Eliminar la copia

Cuando la instalación actualizada funcione, elimina la copia para recuperar su espacio. Su nombre empieza por el del proyecto Compose, que es el nombre del directorio que contiene `compose.yaml`:

```bash
docker volume ls | grep postgres-upgrade-backup
docker volume rm notifuse_postgres-upgrade-backup
```

## Volver atrás

Mientras exista la copia, puedes volver a PostgreSQL 17 y a los datos tal como estaban antes de la actualización. Todo lo escrito desde la actualización se pierde.

```bash
docker compose down
# Put back the compose.yaml of your previous release, for example 43.0:
curl -fsSL https://raw.githubusercontent.com/Notifuse/notifuse/v43.0/compose.yaml -o compose.yaml
# Replace the PostgreSQL 18 data with the copy (project "notifuse": adjust both volume names)
docker run --rm -v notifuse_postgres-upgrade-backup:/from -v notifuse_postgres-data:/to alpine \
  sh -c 'find /to -mindepth 1 -delete && cp -a /from/pg17/. /to/'
docker compose up -d
```

## Quedarse en PostgreSQL 17

En tu `compose.yaml`, mantén juntas la imagen y la ruta de montaje, y quita la actualización:

- `image: postgres:17-alpine` en el servicio `postgres`;
- su volumen montado en `/var/lib/postgresql/data` (`- postgres-data:/var/lib/postgresql/data`);
- el servicio `pg-upgrade` y el `depends_on` de `postgres` sobre él, eliminados.

La etiqueta y la ruta van a la par: PostgreSQL 18 guarda sus datos en `/var/lib/postgresql/18/docker`, y 17 en `/var/lib/postgresql/data`.

## Con tu propio archivo Compose

Si ejecutas PostgreSQL desde tu propio archivo, actualiza de la misma forma: detén el stack, haz una copia de seguridad, copia el volumen y ejecuta una vez pgautoupgrade sobre él, montado en `/var/lib/postgresql`:

```bash
docker run --rm -v <your volume>:/var/lib/postgresql \
  -e POSTGRES_USER=<your user> -e POSTGRES_PASSWORD=<your password> \
  -e PGAUTO_ONESHOT=yes -e PGAUTO_REINDEX=no pgautoupgrade/pgautoupgrade:18-alpine
```

Después usa `postgres:18-alpine` con el volumen montado en `/var/lib/postgresql`. `PGAUTO_REINDEX=no` solo es seguro cuando las dos imágenes son Alpine; desde un `postgres:17` basado en Debian, usa `pgautoupgrade:18-trixie` sin esa variable, para que se reconstruyan los índices.

> [!WARNING]
>
> Nunca definas `PGDATA` para saltarte un error de arranque de PostgreSQL 18. Con un `PGDATA` explícito, la imagen deja de buscar datos de una versión anterior e inicializa una base de datos vacía junto a la tuya en lugar de negarse a arrancar. Cuando PostgreSQL se niega a arrancar, esa negativa protege tus datos.

## Conviene saber

- `docker compose down -v` y `docker volume prune` eliminan la base de datos y la copia.
- Una base de datos actualizada conserva los checksums de datos desactivados, como la creó PostgreSQL 17; una instalación nueva de PostgreSQL 18 los tiene activados.
- Actualiza en la misma arquitectura de CPU en la que se creó la base de datos: no combines con la actualización un traslado entre servidores x86 y ARM.
- pgautoupgrade no admite servidores PostgreSQL con SSL activado ni tablespaces en volúmenes separados, y `compose.yaml` no usa ninguna de las dos cosas. En esos casos, traslada los datos con una [copia de seguridad y una restauración](https://www.notifuse.com/es/docs/self-hosting/backups.md).
