// travaux pratiques · Fondamentaux en informatique
TP01 - Installer PostgreSQL et se connecter avec psql
- TP 1 / 7
- 7 étapes
- ≈ 40 min
- Accès libre
Objectif : installer PostgreSQL 17 depuis les dépôts Debian 13, vérifier que l’instance tourne, s’y connecter avec psql et repérer les fichiers de configuration, de données et de journaux que l’on manipulera dans tous les TP suivants.
Contexte
Dans la plupart des organisations, PostgreSQL arrive d’abord « avec » une application : un outil de supervision, une GMAO, un outil de gestion de parc, un ERP ou un logiciel métier. Le technicien qui doit le dépanner un vendredi soir gagne un temps précieux s’il sait où se trouvent la configuration, les données et les journaux, et comment se connecter sans casser l’existant. Dans une petite structure, une seule instance héberge souvent toutes les bases ; dans un grand groupe, les instances sont nombreuses, standardisées et déployées par des outils d’automatisation, mais les repères sont exactement les mêmes.
À la fin de ce TP, vous saurez installer le serveur, identifier son « cluster » (au sens PostgreSQL : une instance et son répertoire de données), vous y connecter en administrateur et lire ses principaux paramètres.
Prérequis : une machine virtuelle Debian 13 « trixie » nommée pg01 (2 vCPU, 2 Go de RAM, 20 Go de disque), à jour, avec un compte disposant de sudo et un accès Internet pour les paquets. Une seconde VM Debian 13 nommée admin01 servira de poste client à partir du TP06 ; dans ce cours, le réseau du laboratoire est 192.168.56.0/24 (pg01 = 192.168.56.10, admin01 = 192.168.56.20).
Durée estimée : 40 minutes.
Actions à réaliser
1. Préparer la machine
Un serveur de bases de données doit avoir un nom stable et un système à jour avant l’installation : les paquets PostgreSQL de Debian reçoivent les correctifs de sécurité par le même canal que le reste du système.
sudo hostnamectl set-hostname pg01
sudo apt update
sudo apt full-upgrade -y
Résultat attendu : la commande hostnamectl affiche pg01 comme nom statique et apt ne propose plus de mise à jour en attente.
2. Installer PostgreSQL depuis les dépôts Debian
Le métapaquet postgresql de Debian 13 installe la version majeure 17 (paquet postgresql-17), ainsi que postgresql-common, qui fournit les outils d’administration propres à Debian (pg_lsclusters, pg_ctlcluster, pg_createcluster…). L’installation crée automatiquement un premier cluster nommé main et le démarre.
sudo apt install -y postgresql
psql --version
Résultat attendu : psql --version indique une version 17.x. Si vous avez besoin d’une version plus récente (la 19 est sortie le 19 novembre 2026), le dépôt officiel du projet, apt.postgresql.org (PGDG), la fournit pour Debian ; restez sur la version 17 pour ce cours, les commandes sont identiques.
3. Identifier le cluster et le service
Debian peut faire cohabiter plusieurs versions et plusieurs clusters sur une même machine, chacun identifié par sa version et son nom. pg_lsclusters en donne la liste, avec le port, l’état, le propriétaire, le répertoire de données et le fichier journal.
pg_lsclusters
systemctl status postgresql@17-main
sudo ss -ltnp | grep 5432
Résultat attendu : une ligne pour le cluster 17 main, port 5432, état online, propriétaire postgres, données dans /var/lib/postgresql/17/main. Le service est active (running). ss montre le port 5432 en écoute uniquement sur 127.0.0.1 et ::1 : par défaut, le paramètre listen_addresses vaut localhost et le serveur n’est pas joignable depuis le réseau.
4. Se connecter en administrateur avec psql
L’installation crée le compte système postgres et le rôle PostgreSQL du même nom, superutilisateur de l’instance. Sous Debian, les connexions locales par socket Unix utilisent la méthode peer : PostgreSQL vérifie que le nom du compte système correspond au nom du rôle, sans mot de passe. On se connecte donc en empruntant l’identité postgres.
sudo -u postgres psql
Une fois l’invite postgres=# affichée (le # signale un superutilisateur), exécutez :
\conninfo
SELECT version();
\l
\du
\q
\conninfo rappelle la base, l’utilisateur et le socket utilisés ; \l liste les bases : postgres (base d’administration par défaut), template1 (modèle copié à chaque CREATE DATABASE) et template0 (modèle vierge, non modifiable) ; \du liste les rôles et leurs attributs.
Résultat attendu : trois bases, un seul rôle (postgres) avec les attributs Superuser, Create role, Create DB, Replication et Bypass RLS.
5. Lire les paramètres essentiels
Plutôt que de chercher les fichiers sur le disque, demandez-les au serveur : c’est la méthode fiable sur n’importe quelle distribution ou image de conteneur.
sudo -u postgres psql -c "SHOW config_file;" -c "SHOW hba_file;" -c "SHOW data_directory;"
sudo -u postgres psql -c "SHOW listen_addresses;" -c "SHOW port;" -c "SHOW password_encryption;"
Résultat attendu : /etc/postgresql/17/main/postgresql.conf, /etc/postgresql/17/main/pg_hba.conf, /var/lib/postgresql/17/main, puis localhost, 5432 et scram-sha-256 (valeur par défaut depuis PostgreSQL 14). Notez la séparation propre à Debian : la configuration est sous /etc, les données sous /var/lib.
6. Lire le fichier pg_hba.conf
Le fichier pg_hba.conf (host-based authentication) décide qui peut se connecter, à quelle base, d’où et avec quelle méthode. Il est lu de haut en bas et la première ligne qui correspond s’applique.
sudo grep -Ev '^\s*(#|$)' /etc/postgresql/17/main/pg_hba.conf
Résultat attendu : des lignes local en méthode peer pour les sockets Unix, des lignes host pour 127.0.0.1/32 et ::1/128 avec une méthode par mot de passe (scram-sha-256, ou md5 sur certaines versions de postgresql-common : avec un mot de passe stocké en SCRAM, la méthode md5 déclenche de toute façon une authentification SCRAM), et des lignes replication. Aucune ligne n’autorise un réseau distant : c’est le TP06 qui l’ouvrira, de façon restreinte.
7. Consulter le journal du serveur
Le journal de PostgreSQL est le premier endroit à lire quand un service refuse de démarrer ou qu’une application signale une erreur de connexion.
sudo tail -n 20 /var/log/postgresql/postgresql-17-main.log
Résultat attendu : des lignes horodatées indiquant le démarrage du serveur, l’écoute sur le port 5432 et le message « database system is ready to accept connections ».
Vérification
Le TP est réussi si : pg_lsclusters affiche 17 main 5432 online ; sudo -u postgres psql -c "SELECT 1;" renvoie une ligne contenant 1 ; ss ne montre le port 5432 que sur les adresses de bouclage ; vous savez retrouver, avec SHOW, le chemin de postgresql.conf, de pg_hba.conf et du répertoire de données.
Problèmes fréquents
- « psql: error: connection to server on socket … failed: FATAL: role “stagiaire” does not exist » : vous avez lancé
psqlavec votre compte habituel. Aucun rôle PostgreSQL ne porte ce nom. Utilisezsudo -u postgres psql; un rôle nominatif sera créé au TP02. - « Peer authentication failed for user “postgres” » : vous avez tapé
psql -U postgresdepuis votre compte. La méthodepeerexige que le compte système porte le même nom que le rôle : passez parsudo -u postgres. - Le cluster est
down: lisez le journal indiqué parpg_lsclusters, corrigez la cause (disque plein, erreur de syntaxe danspostgresql.conf…), puissudo pg_ctlcluster 17 main start. - « could not change directory to “/home/stagiaire”: Permission denied » : simple avertissement de
sudo -u postgres, le comptepostgresne peut pas lire votre répertoire personnel. Lancez la commande depuis/tmpou ignorez le message.
Bonnes pratiques et sécurité
- Ne donnez pas de mot de passe au rôle
postgrestant qu’aucun besoin ne l’impose : l’accès parpeerréserve l’administration aux comptes autorisés à utilisersudo. - Laissez
listen_addressessurlocalhosttant que le serveur n’a pas besoin d’être joint par le réseau. - Installez PostgreSQL depuis les dépôts de la distribution ou depuis le dépôt officiel PGDG, jamais depuis une archive téléchargée au hasard : les mises à jour mineures, qui corrigent des failles, arrivent alors avec
apt. - Planifiez le cycle de vie : chaque version majeure est maintenue cinq ans par le projet (la 14 n’est plus maintenue depuis novembre 2026).
Questions de contrôle
1. Pourquoi sudo -u postgres psql fonctionne-t-il sans mot de passe ?
Voir la réponse
La ligne local de pg_hba.conf utilise la méthode peer : le serveur obtient du noyau le nom du compte système connecté au socket (postgres) et l’accepte car il correspond au rôle demandé.
2. Dans quel fichier et par quel paramètre décide-t-on des adresses IP sur lesquelles le serveur écoute ?
Voir la réponse
Dans postgresql.conf, avec listen_addresses (par défaut localhost). Le changer nécessite un redémarrage de l’instance.
3. À quoi sert la base template1 ?
Voir la réponse
C’est le modèle copié par défaut lors d’un CREATE DATABASE : ce qu’on y ajoute se retrouve dans toutes les nouvelles bases.
Pour aller plus loin
Comparez avec l’installation de MariaDB présentée dans notre article MariaDB, la base de données open source : les notions de service, de port et de comptes se retrouvent, avec un vocabulaire différent. Dans un grand parc, l’installation et le fichier pg_hba.conf sont généralement déployés par un outil comme Ansible plutôt qu’à la main. Conservez la VM pg01 telle quelle : le TP02 y crée la base du laboratoire.
// formation sur mesure
Former votre équipe sur ce sujet ?
Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.