Guide d'installation PostgreSQL et pgAdmin sur Ubuntu
Table des matières
1. Prérequis
2. Installation de PostgreSQL
3. Configuration initiale de PostgreSQL
4. Installation de pgAdmin
5. Configuration de pgAdmin
6. Test de connexion
7. Commandes utiles
8. Dépannage
Prérequis
Ubuntu 20.04, 22.04 ou version ultérieure
Accès root ou utilisateur avec privilèges sudo
Connexion internet active
Installation de PostgreSQL
Méthode 1 : Installation depuis les dépôts Ubuntu (Recommandée)
bash
# Mise à jour du système
sudo apt update
sudo apt upgrade -y
# Installation de PostgreSQL et des packages additionnels
sudo apt install postgresql postgresql-contrib -y
Méthode 2 : Installation depuis le dépôt officiel PostgreSQL
bash
# Installation des dépendances
sudo apt install wget ca-certificates
# Ajout de la clé GPG officielle PostgreSQL
wget --quiet -O - [Link] | sudo apt-key add
# Ajout du dépôt PostgreSQL
echo "deb [Link] $(lsb_release -cs)-pgdg main" | sudo
# Mise à jour des sources et installation
sudo apt update
sudo apt install postgresql postgresql-contrib -y
Vérification de l'installation
bash
# Vérifier le statut du service
sudo systemctl status postgresql
# Vérifier la version installée
sudo -u postgres psql -c "SELECT version();"
Configuration initiale de PostgreSQL
Démarrage et activation du service
bash
# Démarrer le service PostgreSQL
sudo systemctl start postgresql
# Activer le démarrage automatique
sudo systemctl enable postgresql
# Vérifier que le service fonctionne
sudo systemctl is-active postgresql
Configuration du superutilisateur postgres
bash
# Se connecter en tant qu'utilisateur postgres
sudo -i -u postgres
# Accéder à l'invite PostgreSQL
psql
# Modifier le mot de passe de l'utilisateur postgres
\password postgres
# Quitter psql
\q
# Retourner à votre utilisateur
exit
Création d'un utilisateur et d'une base de données
bash
# Se connecter en tant qu'utilisateur postgres
sudo -u postgres psql
# Créer un nouvel utilisateur
CREATE USER monuser WITH PASSWORD 'motdepasse';
# Créer une base de données
CREATE DATABASE mabase OWNER monuser;
# Accorder tous les privilèges
GRANT ALL PRIVILEGES ON DATABASE mabase TO monuser;
# Quitter
\q
Configuration des connexions (optionnel)
bash
# Éditer le fichier de configuration principal
sudo nano /etc/postgresql/*/main/[Link]
# Modifier la ligne listen_addresses pour permettre les connexions externes
# listen_addresses = 'localhost' # Par défaut
# listen_addresses = '*' # Pour toutes les interfaces
# Éditer le fichier d'authentification
sudo nano /etc/postgresql/*/main/pg_hba.conf
# Redémarrer PostgreSQL pour appliquer les changements
sudo systemctl restart postgresql
Installation de pgAdmin
Méthode 1 : Installation de pgAdmin 4 (Interface web)
bash
# Installation des dépendances
sudo apt install curl
# Ajout de la clé GPG de pgAdmin
curl -fsS [Link] | sudo gpg --dearmor
# Ajout du dépôt pgAdmin
sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/[Link]] https://
# Mise à jour des sources
sudo apt update
# Installation de pgAdmin4
sudo apt install pgadmin4 -y
# Ou installation spécifique :
# sudo apt install pgadmin4-web # Version web seulement
# sudo apt install pgadmin4-desktop # Version desktop seulement
Méthode 2 : Installation via Snap
bash
sudo snap install pgadmin4
Configuration de pgAdmin4 (Version web)
bash
# Configuration initiale de pgAdmin4 web
sudo /usr/pgadmin4/bin/[Link]
# Suivre les instructions pour :
# - Créer un compte administrateur
# - Configurer le serveur web
Configuration de pgAdmin
Première connexion à pgAdmin4 (Version web)
1. Ouvrez votre navigateur et allez à : [Link]
2. Connectez-vous avec les identifiants créés lors de la configuration
3. Cliquez sur "Add New Server" pour ajouter votre serveur PostgreSQL
Configuration de la connexion au serveur
1. Onglet General :
Name : Local PostgreSQL
Server Group : Servers
2. Onglet Connection :
Host name/address : localhost
Port : 5432
Maintenance database : postgres
Username : postgres (ou votre utilisateur)
Password : votre_mot_de_passe
3. Cliquer sur "Save"
Test de connexion
Test via ligne de commande
bash
# Test de connexion locale
psql -U postgres -h localhost -d postgres
# Test avec un utilisateur spécifique
psql -U monuser -h localhost -d mabase
# Test de création d'une table simple
CREATE TABLE test (id SERIAL PRIMARY KEY, nom VARCHAR(100));
INSERT INTO test (nom) VALUES ('Test réussi');
SELECT * FROM test;
DROP TABLE test;
Test via pgAdmin
1. Connectez-vous à pgAdmin4
2. Développez votre serveur dans l'arbre de navigation
3. Cliquez sur "Databases" puis sur votre base de données
4. Utilisez l'outil Query pour exécuter des requêtes SQL
Commandes utiles
Gestion du service PostgreSQL
bash
# Démarrer PostgreSQL
sudo systemctl start postgresql
# Arrêter PostgreSQL
sudo systemctl stop postgresql
# Redémarrer PostgreSQL
sudo systemctl restart postgresql
# Recharger la configuration
sudo systemctl reload postgresql
# Voir les logs
sudo journalctl -u postgresql
Commandes psql utiles
bash
# Se connecter à PostgreSQL
sudo -u postgres psql
# Lister les bases de données
\l
# Se connecter à une base de données
\c nom_base
# Lister les tables
\dt
# Lister les utilisateurs
\du
# Voir les connexions actives
\conninfo
# Aide
\?
# Quitter
\q
Sauvegarde et restauration
bash
# Sauvegarder une base de données
sudo -u postgres pg_dump nom_base > [Link]
# Restaurer une base de données
sudo -u postgres psql nom_base < [Link]
# Sauvegarder toutes les bases
sudo -u postgres pg_dumpall > sauvegarde_complete.sql
Dépannage
Problèmes courants
1. Service PostgreSQL ne démarre pas
bash
# Vérifier les logs
sudo journalctl -u postgresql -f
# Vérifier la configuration
sudo -u postgres /usr/lib/postgresql/*/bin/postgres -D /var/lib/postgresql/*/main/ -C c
2. Impossible de se connecter
bash
# Vérifier que PostgreSQL écoute
sudo netstat -plntu | grep :5432
# Vérifier la configuration pg_hba.conf
sudo nano /etc/postgresql/*/main/pg_hba.conf
3. pgAdmin4 ne s'ouvre pas
bash
# Vérifier le statut du serveur web
sudo systemctl status apache2
# ou
sudo systemctl status nginx
# Reconfigurer pgAdmin4
sudo /usr/pgadmin4/bin/[Link]
4. Erreur d'authentification
Vérifiez que le mot de passe est correct
Vérifiez la configuration dans pg_hba.conf
Redémarrez PostgreSQL après toute modification
Localisation des fichiers importants
bash
# Fichiers de configuration PostgreSQL
/etc/postgresql/*/main/[Link]
/etc/postgresql/*/main/pg_hba.conf
# Répertoire des données
/var/lib/postgresql/*/main/
# Logs PostgreSQL
/var/log/postgresql/
# Fichiers pgAdmin4
/usr/pgadmin4/
/var/lib/pgadmin/
Désinstallation (si nécessaire)
bash
# Désinstaller PostgreSQL
sudo apt remove postgresql postgresql-contrib -y
sudo apt autoremove -y
# Supprimer les données (ATTENTION : irréversible)
sudo rm -rf /var/lib/postgresql/
sudo rm -rf /etc/postgresql/
# Désinstaller pgAdmin4
sudo apt remove pgadmin4 -y
Conclusion
Vous devriez maintenant avoir une installation complète et fonctionnelle de PostgreSQL et pgAdmin4
sur votre système Ubuntu. N'hésitez pas à consulter la documentation officielle pour des configurations
avancées :
Documentation PostgreSQL
Documentation pgAdmin
Pour des questions spécifiques ou des problèmes non couverts dans ce guide, consultez les forums
communautaires ou la documentation officielle.
