Guide & Tutorial

PostgreSQL 14 fine supporto: come aggiornare anche su Docker

PostgreSQL 14 è a fine supporto dal 12 novembre 2026. A quale versione passare, come aggiornare con Docker o pg_upgrade e cosa controllare prima del salto.

Cosmin-Anton Mihoc
8 min di lettura
PostgreSQL 14 fine supporto: come aggiornare anche su Docker
Indice dei contenuti (9 sezioni)

PostgreSQL 14 è a fine supporto dal 12 novembre 2026: la 14.25 è l'ultima versione della serie e da quella data non arrivano più correzioni di sicurezza né di bug. Il database continua a funzionare, ma ogni nuova falla resterà aperta. La strada giusta è passare a una versione ancora supportata, oggi PostgreSQL 18 (supporto fino al 14 novembre 2030), con pg_upgrade oppure con dump e ripristino.

La scadenza arriva insieme a un rilascio pesante. Il 12 novembre 2026 le versioni 18.7, 17.12, 16.16, 15.20 e 14.25 hanno chiuso 52 vulnerabilità e oltre 140 bug.

La più grave, CVE-2026-6460, vale 8,8 su 10 nella scala CVSS 3 (gravità alta): è una confusione di tipo dopo un ALTER ... SET DATA TYPE che permette a un utente del database con il permesso di creare oggetti di eseguire codice arbitrario sul server, con l'utente di sistema che fa girare PostgreSQL.

La 14.25 la corregge, ma è l'ultima patch che PostgreSQL 14 riceverà. Come per la patch di PHP2Shell, il rischio vero è restare su una versione che nessuno corregge più.

Cosa significa la fine del supporto di PostgreSQL 14

Il progetto PostgreSQL supporta ogni versione maggiore per 5 anni dalla prima uscita. PostgreSQL 14 è uscito il 30 settembre 2021 e ha chiuso il ciclo con la 14.25.

  • Il server non si spegne: i dati restano dove sono e le applicazioni continuano a connettersi.
  • Niente più patch: una falla scoperta domani su PostgreSQL 14 resta senza correzione ufficiale.
  • Il supporto esteso di terzi, quando esiste, è un accordo commerciale separato e non una patch del progetto.

A quale versione passare: le date di supporto

Versione Ultima minor al 16/11/2026 Supporto fino al
PostgreSQL 18 18.7 14 novembre 2030
PostgreSQL 17 17.12 8 novembre 2029
PostgreSQL 16 16.16 9 novembre 2028
PostgreSQL 15 15.20 11 novembre 2027
PostgreSQL 14 14.25 (ultima) 12 novembre 2026, terminato

Passare da PostgreSQL 14 alla 15 sposta il problema di un anno appena. Si può saltare direttamente alla 18 senza passare dalle versioni intermedie, leggendo però le note di migrazione di ognuna.

Se applicazione, driver ed estensioni lo permettono, partirei dalla 18: è quella con più anni di supporto davanti, e il tag postgres:latest dell'immagine Docker ufficiale punta già alla 18.7.

Conviene aspettare PostgreSQL 19?

La 19 è alla seconda release candidate e l'uscita definitiva è prevista per il 19 novembre 2026.

Per un database di produzione non aspetterei: la 18 è stabile oggi, e chi sceglie la 19 con pg_upgrade deve leggere le note di migrazione se usa indici di ricerca testuale, pg_trgm o fuzzystrmatch, perché potrebbe doverli ricostruire.

Come capire quale versione stai usando

Da qualsiasi client SQL:

SHOW server_version;

Con Docker Compose, sostituendo db con il nome del tuo servizio e postgres con il tuo utente:

docker compose exec db psql -U postgres -c "SHOW server_version;"

Su Debian e Ubuntu con i pacchetti ufficiali, pg_lsclusters elenca tutti i cluster installati con versione e porta.

Prima di aggiornare: la checklist

  1. Backup logico completo con pg_dumpall, salvato fuori dal server. Per cambiare versione maggiore una copia della cartella dati non serve: ci vuole un backup logico.
  2. Elenco delle estensioni con SELECT extname, extversion FROM pg_extension;. Estensioni come PostGIS o pgvector, quella usata per i database vettoriali, vanno installate anche per la nuova versione.
  3. Una prova su una copia con dati realistici, prima di toccare la produzione.
  4. Una finestra di manutenzione con tutte le scritture ferme: applicazione, worker, cron e integrazioni.

Sui server che gestisco i backup finiscono su Storage Box e su Object Storage S3, non sullo stesso disco del database. È il dettaglio che conta in un aggiornamento: se qualcosa va storto, il backup deve restare raggiungibile anche con il server fuori uso.

Per un ecommerce che seguo su codice e server ho impostato stage e produzione separati. Un ambiente di stage è il posto giusto per provare un salto di versione del database con dati veri, misurando quanto dura il ripristino.

Aggiornare PostgreSQL 14 su Docker

Su Docker il container non si aggiorna in place: si crea un database nuovo con l'immagine 18 e ci si riversano i dati. Se nel tuo compose c'è image: postgres:14, cambiare solo il tag non basta, perché il server nuovo rifiuta una cartella dati creata da un'altra versione maggiore.

Vale anche per le app self-hosted che girano con Postgres in un container, come n8n installato seguendo la guida a n8n su server.

Dalla 18 cambia il percorso del volume

Fino alla 17 l'immagine ufficiale tiene i dati in /var/lib/postgresql/data. Dalla 18 la variabile PGDATA diventa /var/lib/postgresql/18/docker e il volume va montato su /var/lib/postgresql. Il nuovo servizio nel compose diventa così:

services:
  db:
    image: postgres:18
    environment:
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - pgdata18:/var/lib/postgresql

volumes:
  pgdata18:

La procedura passo passo

  1. Ferma i servizi che scrivono nel database, lasciando acceso solo il database: docker compose stop app (usa il nome del tuo servizio applicativo).
  2. Esporta tutto, ruoli compresi: docker compose exec -T db pg_dumpall -U postgres > backup-pg14.sql
  3. Spegni lo stack con docker compose down, senza l'opzione -v, che cancellerebbe i volumi.
  4. Nel compose cambia immagine e volume come nell'esempio sopra. Il volume vecchio resta intatto.
  5. Avvia solo il database nuovo: docker compose up -d db
  6. Ripristina: docker compose exec -T db psql -U postgres -d postgres < backup-pg14.sql. Un errore che dice che il ruolo postgres esiste già è atteso, perché lo ha creato il container nuovo all'avvio.
  7. Rigenera le statistiche: docker compose exec db vacuumdb -U postgres --all --analyze-in-stages
  8. Riavvia tutto con docker compose up -d e prova le operazioni che contano: un login, una scrittura, un report.

Se usi un utente diverso da postgres (variabile POSTGRES_USER), mettilo al posto di postgres nei comandi. La documentazione di PostgreSQL ammette il dump fatto con la versione in uso, ma consiglia, quando si può, il pg_dumpall della versione nuova.

Il vantaggio di questa strada è il ritorno indietro: finché non cancelli il volume vecchio, rimettere postgres:14 e il volume precedente ti riporta alla situazione di partenza.

Aggiornare su Debian e Ubuntu con pg_upgradecluster

Se PostgreSQL è installato dai pacchetti della distribuzione o dal repository ufficiale, pg_upgradecluster fa quasi tutto: crea il cluster nuovo, copia e adatta la configurazione, sposta il vecchio cluster su un'altra porta e lascia al nuovo quella originale.

# dopo aver installato i pacchetti della 18 (server ed estensioni)
sudo pg_upgradecluster --check -v 18 14 main
sudo pg_upgradecluster -v 18 14 main
  • Con --check verifica che siano installati tutti i pacchetti che servono alla nuova versione.
  • Il metodo predefinito è il dump: più lento, ma sicuro. Con -m upgrade usa pg_upgrade ed è più veloce.
  • Se hai aggiornato anche il sistema operativo, gli indici sul testo potrebbero richiedere una ricostruzione per via delle collation: pg_upgradecluster non lo fa da solo.
  • Il cluster di PostgreSQL 14 non viene cancellato: passa all'avvio manuale. Quando hai verificato che la 18 funziona, lo rimuovi con pg_dropcluster --stop 14 main.

pg_upgrade o dump e ripristino: quale scegliere

Metodo Quando usarlo A cosa fare attenzione
Dump e ripristino Database piccoli o medi, Docker, cambio di server Il fermo dura quanto esportazione e importazione
pg_upgrade in copia Server dove hai accesso a file e binari Serve spazio per una seconda copia dei dati
pg_upgrade con --link Database grandi con fermo minimo Dopo l'avvio del nuovo cluster il vecchio non è più utilizzabile
Replica logica Fermo di pochi secondi Più parti in movimento da controllare

Con pg_upgrade valgono tre regole. Si lancia il binario della versione nuova, non della vecchia. Prima si esegue sempre pg_upgrade --check, che controlla la compatibilità senza toccare i dati. Le librerie delle estensioni vanno installate per la nuova versione prima di partire.

Su un database gestito in cloud non hai accesso ai file: o il fornitore offre l'aggiornamento di versione dalla console, o crei una nuova istanza e sposti i dati con dump e ripristino. Vale anche per i servizi Postgres gratuiti che trovi nella guida all'hosting gratuito per sviluppatori.

Se sei su 15, 16, 17 o 18: aggiorna comunque la minor

Chi non è su PostgreSQL 14 non ha la scadenza, ma ha le stesse 52 vulnerabilità da chiudere. L'aggiornamento minore è semplice: fermi il servizio, sostituisci i binari e riavvii, senza dump né pg_upgrade. Con Docker basta portare il tag alla nuova minor, per esempio postgres:18.7, e ricreare il container.

Questa volta però ci sono passaggi in più dopo l'aggiornamento:

  • ricostruire con REINDEX gli indici GIN che sospetti danneggiati e gli indici GiST che usano pg_trgm;
  • ricostruire gli indici B-tree su colonne bpchar senza lunghezza;
  • fare un nuovo backup completo se usi i backup incrementali, e usarlo come base dei successivi.

Quando conviene farsi aiutare

Un database da pochi gigabyte con un'app sola si aggiorna in una sera seguendo i passaggi sopra. Il discorso cambia con più applicazioni sullo stesso server, repliche, estensioni compilate o un fermo che deve stare in pochi minuti.

Anche Stanzia, il software per B&B e hotel che sviluppo, usa PostgreSQL insieme a Redis e Fastify: in un'applicazione così il database non si aggiorna da solo, vanno ricontrollati driver, backup e monitoraggio.

Se devi portare PostgreSQL 14 su una versione supportata senza fermare il lavoro, posso occuparmene io, dalla prova su una copia al monitoraggio dopo il passaggio, all'interno delle mie integrazioni e lavori su server per aziende. Per un primo confronto scrivimi qui.

Condividi questo articolo
Hai domande? Contattami

Pronto a dare vita al tuo progetto?

Contattami per discutere della tua idea e ricevere una consulenza gratuita.

Iniziamo insieme