Si tu PostgreSQL en Docker ha dejado de arrancar hoy, la causa es que postgres:latest ha pasado de la 18 a la 19.0 y la imagen nueva se niega a abrir un directorio de datos de la 18. Tus datos no se pierden: el contenedor sale con código 1 antes de tocar nada. Cambia postgres:latest por postgres:18 en tu compose para volver a funcionar, y después actualiza a la 19 con pg_dumpall y una restauración o con pg_upgrade --link en el mismo volumen. Lo reproduje el 20 de noviembre de 2026 en Linux arm64 con Docker 29.5.2, Compose v2.40.3, postgres:18 (18.7) y postgres:19 (19.0). Tienes la versión en inglés de esta guía.

Puntos clave

  • Docker Hub publicó postgres:19, 19.0 y latest con la 19.0 hacia las 04:10 UTC del 20 de noviembre de 2026, un día después del anuncio oficial.
  • Con el volumen montado en /var/lib/postgresql, como recomienda la imagen desde la 18, la 19 se para con there appears to be PostgreSQL data in: /var/lib/postgresql/18/docker y no crea una base vacía.
  • Si fijaste PGDATA=/var/lib/postgresql/data, el mensaje es otro: FATAL: database files are incompatible with server.
  • Volver a postgres:18 arrancó la base con las 50 000 filas de prueba intactas.
  • pg_dumpall con el cliente de la 19 y pg_upgrade --link en el mismo volumen pasaron los datos a la 19.0; ni pgautoupgrade ni tianon/postgres-upgrade tenían aún una imagen para la 19.

¿Qué error da postgres:latest con un volumen de la 18?

La imagen de la 19 busca su clúster en /var/lib/postgresql/19/docker, encuentra uno de la 18 en /var/lib/postgresql/18/docker y termina con un error del script de entrada. Este es el compose de la prueba, el que recomienda la imagen oficial desde la 18, con un solo volumen en /var/lib/postgresql:

services:
  db:
    image: postgres:${PG_TAG:-18}
    environment:
      POSTGRES_PASSWORD: cambia_esta_clave
      POSTGRES_DB: tienda
    ports:
      - "127.0.0.1:5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql
volumes:
  pgdata:

Arranqué la 18.7, creé una tabla pedidos con 50 000 filas, paré el servicio y lo levanté con PG_TAG=latest. El contenedor salió con código 1 a los pocos segundos y este es su registro completo:

$ docker compose logs --no-log-prefix db
Error: in 18+, these Docker images are configured to store database data in a
       format which is compatible with "pg_ctlcluster" (specifically, using
       major-version-specific directory names).  This better reflects how
       PostgreSQL itself works, and how upgrades are to be performed.

       See also https://github.com/docker-library/postgres/pull/1259

       Counter to that, there appears to be PostgreSQL data in:
         /var/lib/postgresql/18/docker

       This is usually the result of upgrading the Docker image without
       upgrading the underlying database using "pg_upgrade" (which requires both
       versions).

       The suggested container configuration for 18+ is to place a single mount
       at /var/lib/postgresql which will then place PostgreSQL data in a
       subdirectory, allowing usage of "pg_upgrade --link" without mount point
       boundary issues.

       See https://github.com/docker-library/postgres/issues/37 for a (long)
       discussion around this process, and suggestions for how to do so.

El mensaje dice que la imagen se actualizó sin actualizar la base. Después del fallo revisé el volumen: 18/docker seguía con sus 67 MB y la 19 solo había dejado un directorio 19/docker vacío. La base no apareció vacía en ningún momento, porque la 19 no llega a ejecutar initdb. La aplicación conectada sí pierde la base, ya que el servicio queda parado.

¿Y si el error es database files are incompatible with server?

Ese segundo mensaje aparece si tu compose fija PGDATA=/var/lib/postgresql/data y monta el volumen ahí, la forma de hacerlo de las imágenes anteriores a la 18 que sigue en tutoriales antiguos. Como la 19 respeta ese PGDATA, el script de entrada no detecta nada raro y es el propio servidor el que se niega. Repetí la prueba con esa configuración y salió esto, partido para que quepa:

PostgreSQL Database directory appears to contain a database; Skipping
initialization

2026-11-20 08:20:27.607 UTC [1] FATAL:  database files are incompatible
with server
2026-11-20 08:20:27.607 UTC [1] DETAIL:  The data directory was
initialized by PostgreSQL version 18, which is not compatible with this
version 19.0 (Debian 19.0-1.pgdg13+1).

Hay una tercera variante si tu volumen viene de la 17 o anterior montado en /var/lib/postgresql/data sin PGDATA: el mismo texto del primer bloque, pero señalando /var/lib/postgresql/data (unused mount/volume). Lo comprobé con un volumen de postgres:17-alpine. Los tres casos se arreglan igual: primero vuelves a la versión con la que se creó el volumen y luego actualizas.

¿Qué cambió en Docker Hub el 20 de noviembre?

El proyecto PostgreSQL publicó la 19.0 el 19 de noviembre de 2026, y Docker Hub movió las etiquetas de la imagen oficial a la mañana siguiente. Esto es lo que devolvían el registro y la API de Docker Hub a las 08:19 UTC del 20 de noviembre:

  • postgres:18: la 18.7, subida a las 04:08 UTC, con resumen de arm64 sha256:af98f9bf838b…
  • postgres:19 y postgres:19.0: la 19.0, subidas a las 04:09 y 04:10 UTC, con resumen de arm64 sha256:75428cce0b85…
  • postgres:latest: la 19.0, subida a las 04:11 UTC, con el mismo resumen de arm64 que 19

latest y 19 tienen índices distintos (fe9ef805… y bb6e70ad…), pero apuntan a las mismas imágenes de amd64 y arm64. Hice todo el laboratorio con la variante arm64; la de amd64 solo la vi en el manifiesto. La 18 no tiene ninguna prisa: según la política de versiones de PostgreSQL[1], recibe parches hasta el 14 de noviembre de 2030 y la 19 hasta el 19 de noviembre de 2031.

Arreglo inmediato: fija postgres:18

Cambia la etiqueta a la versión mayor con la que se creó el volumen y vuelve a levantar el servicio. En mi compose bastó con quitar PG_TAG=latest; en el tuyo, cambia la línea image::

    image: postgres:18

Comprueba que es la 18 y que tus datos están:

docker compose up -d
docker compose exec db psql -U postgres -d tienda \
  -Atc "select count(*), sum(total) from pedidos" \
  -c "select version()"

Devolvió 50000|12524500.00 y PostgreSQL 18.7, los mismos valores que antes del fallo. Lo mismo funcionó con la variante de PGDATA=/var/lib/postgresql/data. Fija la etiqueta aunque hoy no reinicies nada: con latest, el próximo docker compose pull descargaría la 19. A partir de aquí tienes dos caminos para llegar a la 19.

Cómo pasar los datos a la 19 con pg_dumpall

El volcado lógico es el camino con menos piezas: vuelcas la 18 en marcha a un fichero SQL, levantas la 19 con un volumen nuevo y restauras. Las notas de la 19 piden hacer el volcado con el cliente nuevo, y ese aviso no es un formalismo:

"Dumps created using pre-PostgreSQL 19 versions of pg_dump or pg_dumpall, and using standard_conforming_strings = off, will not properly load into PostgreSQL 19 and later servers. Users should create dumps using PostgreSQL 19 or later versions of these applications", notas de la versión 19.0[2], PostgreSQL Global Development Group.

Por eso ejecuté pg_dumpall desde un contenedor postgres:19 conectado a la red del proyecto, contra la 18 en marcha. Compose nombra la red con el nombre del proyecto más _default, y en este ejemplo el proyecto se llama tienda:

docker run --rm --network tienda_default \
  -e PGPASSWORD=cambia_esta_clave postgres:19 \
  pg_dumpall -h db -U postgres > respaldo-18.sql

El fichero ocupó 2,8 MB y su cabecera dice Dumped from database version 18.7 y Dumped by pg_dump version 19.0. Después cambié el servicio a image: postgres:19 con un volumen nuevo, pgdata19:/var/lib/postgresql, sin POSTGRES_DB, y restauré:

docker compose up -d
docker compose exec -T db psql -U postgres -q < respaldo-18.sql

El único error fue ERROR: role "postgres" already exists, esperable porque el volcado incluye ese rol y la imagen ya lo crea. La consulta de comprobación devolvió 50000|12524500.00 con PostgreSQL 19.0 y data_directory en /var/lib/postgresql/19/docker. El volumen viejo queda intacto, así que puedes volver a la 18 si algo falla. La contrapartida es el tiempo de parada: tu aplicación no debe escribir entre el volcado y la restauración.

pg_upgrade --link convierte el clúster de la 18 al formato de la 19 dentro del mismo volumen, creando enlaces duros en lugar de copiar los ficheros. Necesita los binarios de las dos versiones, y cada imagen oficial trae solo los suyos. El 20 de noviembre a las 08:25 UTC, ni pgautoupgrade[3] ni tianon/postgres-upgrade tenían una etiqueta para la 19. Monté una imagen con el truco que usa la segunda, que añade la 18 desde el repositorio de PostgreSQL que la imagen ya trae configurado:

FROM postgres:19
RUN sed -i 's/$/ 18/' /etc/apt/sources.list.d/pgdg.list \
 && apt-get update \
 && apt-get install -y --no-install-recommends postgresql-18 \
 && rm -rf /var/lib/apt/lists/*

La imagen resultante trae postgres 18.7 y pg_upgrade 19.0. En el compose añadí un servicio upgrade que solo arranca bajo demanda, con ese Dockerfile en ./upgrade y el mismo volumen:

  upgrade:
    build: ./upgrade
    profiles: [upgrade]
    volumes:
      - pgdata:/var/lib/postgresql
      - ./upgrade.sh:/upgrade.sh:ro
    entrypoint: ["/upgrade.sh"]

El script crea el clúster de la 19 con la misma codificación y configuración regional que el de la 18 y lanza pg_upgrade en modo comprobación o enlace. Se ejecuta desde /var/lib/postgresql para que los ficheros que deja pg_upgrade queden en el volumen, y copia pg_hba.conf porque el de initdb no permite conexiones desde otros contenedores:

#!/usr/bin/env bash
# usage: upgrade.sh check|link
set -euo pipefail
OLD=/var/lib/postgresql/18/docker
NEW=/var/lib/postgresql/19/docker
if [ ! -s "$NEW/PG_VERSION" ]; then
  install -d -o postgres -g postgres -m 700 "$NEW"
  gosu postgres initdb -D "$NEW" -U postgres \
    --encoding=UTF8 --locale=en_US.utf8 > /dev/null
fi
cd /var/lib/postgresql
MODE=--check; [ "$1" = link ] && MODE=--link
gosu postgres pg_upgrade -U postgres \
  -b /usr/lib/postgresql/18/bin -B /usr/lib/postgresql/19/bin \
  -d "$OLD" -D "$NEW" $MODE
[ "$1" = link ] && cp "$OLD/pg_hba.conf" "$NEW/pg_hba.conf"
exit 0

Si tu base se creó con otra configuración regional, cambia --locale por la tuya (SHOW lc_collate en la 18 te la dice). Con la base parada, primero comprueba y después enlaza:

docker compose stop db
docker compose run --rm upgrade check
docker compose run --rm upgrade link
docker compose rm -sf db
PG_TAG=latest docker compose up -d db

La comprobación terminó con *Clusters are compatible* y el enlace con Upgrade Complete. La 19.0 arrancó sobre /var/lib/postgresql/19/docker con las 50 000 filas y aceptó conexiones desde otro contenedor de la red. Faltan dos pasos que el propio pg_upgrade sugiere: regenerar estadísticas y, cuando estés seguro, borrar el clúster viejo:

docker compose exec db vacuumdb -U postgres --all \
  --analyze-in-stages --missing-stats-only
docker compose exec db sh /var/lib/postgresql/delete_old_cluster.sh

delete_old_cluster.sh solo contiene rm -rf '/var/lib/postgresql/18/docker'. Con --link no hay vuelta atrás una vez arranca la 19: pg_upgrade lo avisa (the old cluster cannot be safely started once the new cluster has been started). Haz una copia del volumen antes. Si tu base usa extensiones o índices GiST sobre inet, lee la sección de pg_upgrade de las novedades de PostgreSQL 19 probadas en Docker: allí la comprobación falló por un índice de btree_gist.

¿Qué método elijo para pasar de la 18 a la 19?

Para una base de unos pocos gigabytes, pg_dumpall es el camino que recomiendo: deja la 18 intacta y no necesita una imagen propia. pg_upgrade --link compensa con bases grandes, donde volcar y restaurar alarga demasiado la parada. Así quedaron los tres caminos en mi prueba:

Método Datos de la 18 Imagen extra Vuelta atrás
Fijar postgres:18 intactos no no aplica
pg_dumpall + restaurar intactos, volumen aparte no volver a la 18
pg_upgrade --link convertidos en el mismo volumen sí, con 18 y 19 solo desde la copia previa

El esquema y los tipos de datos son los mismos con cualquiera de los dos métodos. Antes de elegir, revisa la lista de incompatibilidades de las notas de la 19: elimina el parámetro io_workers, desactiva JIT por defecto y sube max_locks_per_transaction de 64 a 128.

Cómo evitar que latest te vuelva a romper la base

Fija siempre la versión mayor de una base de datos (postgres:18, postgres:19) y deja latest para servicios sin estado. La etiqueta mayor recibe las versiones menores, como la 18.7 de hoy, que no cambian el formato del directorio de datos.

Si usas actualizaciones automáticas, excluye la base: la guía de Watchtower para actualizar contenedores Docker explica cómo hacerlo por etiqueta. Si estás montando una base nueva, la guía de cómo instalar PostgreSQL con Docker ya usa el volumen en /var/lib/postgresql. El mismo patrón de etiqueta flotante que salta de versión ya rompió bitnami/postgresql:latest, y lo explico en el error docker.io/bitnami/postgresql not found.

Preguntas frecuentes

¿Perdí mis datos al arrancar postgres:latest?

No. En las tres variantes que probé, la 19 se detuvo antes de escribir en el clúster de la 18. Solo dejó un directorio 19/docker vacío, que pg_upgrade o la 19 reutilizan más tarde.

¿Puedo seguir usando postgres:18 sin actualizar?

Sí. La 18 recibe parches hasta el 14 de noviembre de 2030, y la etiqueta postgres:18 se seguirá moviendo a cada versión menor nueva. Actualizar a la 19 es una decisión que puedes planificar.

¿Hay una imagen que haga pg_upgrade automáticamente?

pgautoupgrade lo hace para versiones anteriores, pero el 20 de noviembre de 2026 no tenía una etiqueta para la 19. Mientras tanto, la imagen de cuatro líneas de este artículo hace el mismo trabajo.

Conclusión

postgres:latest es la 19.0 desde el 20 de noviembre de 2026 y no abre un volumen de la 18, ni lo vacía. Fija postgres:18 hoy, haz una copia del volumen y elige con calma entre pg_dumpall con el cliente de la 19 y pg_upgrade --link. Antes de cambiar la etiqueta en producción, ensaya el método elegido sobre una copia del volumen. La guía de volúmenes y bind mounts en Docker explica cómo copiar uno.

Fuentes: [1] PostgreSQL 19 Released[4], [2] Notas de la versión 19.0[2], [3] Política de versiones de PostgreSQL[1], [4] Imagen oficial postgres en Docker Hub[5], [5] docker-library/postgres, pull request 1259[6], [6] docker-library/postgres, incidencia 37[7], [7] pgautoupgrade en Docker Hub[3].

Fuentes

  1. política de versiones de PostgreSQL
  2. notas de la versión 19.0
  3. pgautoupgrade
  4. PostgreSQL 19 Released
  5. Imagen oficial postgres en Docker Hub
  6. docker-library/postgres, pull request 1259
  7. docker-library/postgres, incidencia 37