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.
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
- Compose detiene Notifuse y PostgreSQL 17.
- El servicio
pg-upgradecopia los datos de PostgreSQL 17 en el volumenpostgres-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-upgradeindica cuánto espacio necesita. Libera espacio y vuelve a ejecutardocker compose up -d. - Actualiza los datos a PostgreSQL 18 en el mismo lugar, con pgautoupgrade (
pg_upgrade --link). - 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.
Advertencia
La copia es una forma de volver atrás en el mismo disco, no una copia de seguridad. Haz una copia de seguridad 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.
-
Comprueba el espacio libre: la copia necesita tanto como ocupan los datos. Con el stack funcionando en 17:
docker compose exec postgres du -sh /var/lib/postgresql/data df -h /var/lib/docker -
Define
DB_EXPECT_EXISTING=trueen.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
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:
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.
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-alpineen el serviciopostgres;- su volumen montado en
/var/lib/postgresql/data(- postgres-data:/var/lib/postgresql/data); - el servicio
pg-upgradey eldepends_ondepostgressobre é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:
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.
Advertencia
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 -vydocker volume pruneeliminan 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.yamlno usa ninguna de las dos cosas. En esos casos, traslada los datos con una copia de seguridad y una restauración.
