PostgreSQL : installation sur Ubuntu

PostgreSQL est un système de gestion de base de données relationnelle. Ce guide l’installe sur Ubuntu 24.04 et 26.04 et se limite à l’usage en ligne de commande. Les exemples utilisent des noms génériques (boutique, app).

Version fournie par Ubuntu

Ubuntu	Paquet postgresql	Remarque
24.04	PostgreSQL 16	Supportée
26.04	PostgreSQL 18	Dernière version majeure à la sortie d’Ubuntu 26.04

Pour une version plus récente que celle d’Ubuntu (ou pour obtenir la 18 sur Ubuntu 24.04), utiliser le dépôt officiel PGDG (voir plus bas).

Installer

sudo apt update
sudo apt install postgresql

Le paquet crée un cluster nommé main (une instance de PostgreSQL avec ses données) et démarre le service.

sudo systemctl status postgresql          # service global
pg_lsclusters                             # clusters : version, port, état, dossier de données
psql --version
sudo systemctl enable --now postgresql    # démarrage automatique

Premier accès

PostgreSQL crée un compte système postgres, administrateur de l’instance. Par défaut, la connexion locale se fait par ce compte (authentification peer) :

sudo -u postgres psql

SELECT version();
\conninfo
\q

Créer un utilisateur et une base

Voir Rôles et droits. En résumé :

sudo -u postgres createuser --pwprompt app          # demande le mot de passe
sudo -u postgres createdb --owner=app boutique
psql -h 127.0.0.1 -U app boutique                   # test de connexion par mot de passe

Fichiers et emplacements

Remplacer 18 par la version installée (pg_lsclusters).

Élément	Emplacement
Configuration principale	/etc/postgresql/18/main/postgresql.conf
Authentification des clients	/etc/postgresql/18/main/pg_hba.conf
Données	/var/lib/postgresql/18/main
Journal	/var/log/postgresql/postgresql-18-main.log
Service du cluster	postgresql@18-main.service

sudo tail -n 50 /var/log/postgresql/postgresql-18-main.log
sudo systemctl restart postgresql@18-main

Par défaut, PostgreSQL n’écoute que sur localhost (listen_addresses = 'localhost'), port 5432.

Dépôt officiel PGDG (versions plus récentes)

sudo apt install postgresql-common
sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh      # ajoute le dépôt officiel
sudo apt install postgresql-18                                    # version majeure voulue

Plusieurs versions majeures peuvent coexister, chacune avec son cluster sur un port différent (pg_lsclusters).

Passer à une version majeure plus récente

Une mise à jour majeure ne se fait pas par apt upgrade : elle migre les données avec les outils de Debian et Ubuntu.

sudo apt install postgresql-18                    # installe la nouvelle version (crée un cluster vide)
pg_lsclusters
sudo pg_dropcluster 18 main --stop                # supprime le cluster vide de la nouvelle version
sudo pg_upgradecluster 16 main                    # migre le cluster 16 vers la dernière version installée
pg_lsclusters                                     # vérifier que la nouvelle version tourne sur le port 5432
sudo pg_dropcluster 16 main                       # supprime l'ancien cluster, après vérification

Attention

Sauvegarder d’abord (voir Sauvegarde et restauration) et tester sur une copie. N’exécuter la dernière commande (pg_dropcluster 16 main) qu’après avoir vérifié que l’application fonctionne avec la nouvelle version.

Désinstallation

sudo apt purge 'postgresql*'
sudo apt autoremove

Danger

La commande suivante supprime définitivement toutes les données et configurations. N’exécuter qu’après sauvegarde.

sudo rm -rf /var/lib/postgresql /etc/postgresql /var/log/postgresql

Dépannage

Symptôme	Piste
psql: FATAL: Peer authentication failed for user "app"	La connexion locale par socket utilise le compte système : ajouter -h 127.0.0.1 pour s’authentifier par mot de passe
psql: could not connect to server: No such file or directory	Cluster arrêté : pg_lsclusters, sudo systemctl start postgresql
Le cluster est down	sudo tail /var/log/postgresql/postgresql-18-main.log : erreur de configuration, disque plein, port occupé
FATAL: role "app" does not exist	Créer le rôle (voir Rôles et droits)

Ubuntu 24.04 et 26.04 : différences à connaître

Changement cassant — Ubuntu 26.04 : sudo remplacé par sudo-rs

La commande sudo est désormais fournie par sudo-rs (l’ancienne version devient sudo.ws). Les commandes de ce guide fonctionnent à l’identique. Des scripts qui analysent la sortie de sudo, ou une configuration sudoers avancée, sont à revérifier.

Changement cassant — Ubuntu 26.04 : PostgreSQL 18 remplace PostgreSQL 16

Le paquet postgresql passe de la version 16 (24.04) à la version 18 (26.04). Lors de la mise à niveau d’Ubuntu, le cluster 16 reste en place : la migration vers la 18 se fait avec pg_upgradecluster (section précédente) et demande une sauvegarde et un test préalables. Points propres à la version 18 :

• Les sommes de contrôle des données (data checksums) sont activées par défaut dans les nouveaux clusters. Une migration avec pg_upgrade exige des réglages identiques sur l’ancien et le nouveau cluster : vérifier avec SHOW data_checksums; avant de migrer.
• L’authentification des mots de passe par MD5 est dépréciée : privilégier scram-sha-256 (voir Rôles et droits).
• Lire les notes de version de PostgreSQL 18 avant la migration.

Depuis PostgreSQL 15 : schéma public

Un utilisateur ordinaire n’a plus le droit de créer des objets dans le schéma public (droit CREATE retiré). Les droits doivent être accordés explicitement : voir Rôles et droits.

Pour aller plus loin

• Documentation officielle : postgresql.org/docs
• Suite : Console : le client psql

Dans la même rubrique

• Installation
• Console : le client psql
• Bases et tables
• Requêtes SQL
• Rôles et droits
• Sauvegarde et restauration
• Index et performances