Installer PostgreSQL sur macOS

Base de données relationnelle SQL open source, robuste et conforme aux standards.

Base de donnéessqlrdbmsrelationnelacidbase-de-donnees

Installation

Serveur (Homebrew) · Homebrew

$ brew install postgresql@17

Le formula versionné évite les mises à niveau majeures inattendues.

Vérifier l'installation

Vérifier

$ psql --version

Service

Démarrer

$ brew services start postgresql@17

Arrêter

$ brew services stop postgresql@17

Statut

$ brew services info postgresql@17

Redémarrer

$ brew services restart postgresql@17

Fichiers importants

Type	Chemin	Description
data	/opt/homebrew/var/postgresql@17	Répertoire de données du cluster (Apple Silicon). Sur Mac Intel : /usr/local/var/postgresql@17.
config	/opt/homebrew/var/postgresql@17/postgresql.conf	Configuration du serveur, située dans le répertoire de données.
config	/opt/homebrew/var/postgresql@17/pg_hba.conf	Règles d'authentification client, située dans le répertoire de données.

Ports par défaut

5432

Outils en ligne de commande

psqlClient interactif SQL.
pg_dumpSauvegarde logique d'une base.
pg_restoreRestauration depuis une sauvegarde pg_dump au format custom.
createdbCréation rapide d'une base de données.
pg_ctlContrôle bas niveau du serveur.

Désinstaller

brew services stop postgresql@17
brew uninstall postgresql@17

Le répertoire de données n'est pas supprimé : effacez-le manuellement si besoin.

À savoir

Homebrew n'utilise pas systemd : la gestion du service passe par brew services.
Étant un formula versionné, postgresql@17 est keg-only : ses binaires ne sont jamais liés dans le PATH global ; ajoutez /opt/homebrew/opt/postgresql@17/bin au PATH.

Installation avec Homebrew

Homebrew est la méthode standard sur macOS. Le formula postgresql@17 installe le serveur, le client psql et les utilitaires, puis exécute initdb dès l'installation (selon les caveats Homebrew) pour créer le cluster dans le répertoire de données.

L'utilisateur PostgreSQL par défaut correspond à votre compte macOS (et non postgres). Vous pouvez donc vous connecter directement avec psql postgres une fois le service démarré.

Chemins selon l'architecture

Le préfixe Homebrew diffère entre puces : /opt/homebrew sur Apple Silicon (M1/M2/M3…) et /usr/local sur les Mac Intel. Les chemins de données et de configuration indiqués ci-dessus supposent Apple Silicon ; adaptez le préfixe sur Intel.

Piège fréquent : binaires hors du PATH

Comme il s'agit d'un formula versionné, postgresql@17 est toujours « keg-only » : ses binaires ne sont jamais liés dans le PATH global. Vous devez donc ajouter le répertoire bin du formula à votre PATH, par exemple dans ~/.zshrc : export PATH="/opt/homebrew/opt/postgresql@17/bin:$PATH".