Modifier la configuration de la base de données PostgreSQL dans ServBay

ServBay offre aux développeurs macOS un environnement local de développement web puissant, intégrant la base de données PostgreSQL. Ce guide détaille comment modifier les paramètres de configuration de PostgreSQL dans ServBay, en privilégiant l’interface graphique recommandée, tout en présentant la méthode manuelle par modification de fichier à titre temporaire ou avancé.

Selon la version de PostgreSQL installée via ServBay, les fichiers de configuration principaux se trouvent généralement dans le dossier /Applications/ServBay/etc/postgresql/<version>. Par exemple, pour PostgreSQL 16, le chemin sera /Applications/ServBay/etc/postgresql/16.

Conseil important

ServBay gère la plupart des paramètres de configuration via son interface graphique (UI), et génère automatiquement les fichiers de configuration associés. Il est fortement recommandé d’effectuer vos modifications via l’interface ServBay. Éditer les fichiers de configuration à la main expose vos changements à un écrasement lors d’une prochaine gestion ou mise à jour par ServBay. Cette méthode manuelle doit rester réservée à des tests temporaires ou aux utilisateurs expérimentés souhaitant un contrôle bas niveau ; elle n’est pas indiquée pour la configuration à long terme ou en production.

Modification des paramètres via l’interface graphique de ServBay (recommandé)

ServBay propose une interface de gestion intuitive, qui constitue la méthode la plus simple et la plus fiable pour adapter la configuration PostgreSQL. Toute modification via l’UI est prise en compte automatiquement et généralement appliquée instantanément, sans redémarrage manuel du service (sauf indication contraire de ServBay).

Étapes à suivre

1. Lancez l’application ServBay.
2. Dans la barre de navigation à gauche, sélectionnez Base de données.
3. Dans la liste des bases, repérez PostgreSQL, puis cliquez sur la version concernée que vous souhaitez configurer.
4. Une fois dans l’interface de configuration PostgreSQL, vous visualisez les détails et paramètres disponibles pour cette version.

Paramètres configurables

Depuis cette page, ServBay affiche pour vous le nom d’utilisateur et le mot de passe PostgreSQL par défaut (habituellement visibles directement à l’écran). Vous pouvez également adapter plusieurs paramètres courants :

• Adresse(s) d’écoute (listen_addresses) : Détermine les interfaces réseau écoutées par PostgreSQL. Par défaut, la valeur * signifie “toutes les interfaces disponibles”.
• Port (port) : Port réseau d’écoute du service PostgreSQL. Le port standard est 5432 (différent de MySQL/MariaDB qui utilisent 3306).
• Nombre maximal de connexions (max_connections) : Limite le nombre de clients pouvant se connecter simultanément à la base de données.
• Mémoire de travail (work_mem) : Définit la quantité de mémoire utilisable par processus lors des opérations de tri et de hash.

Par ailleurs, la zone Additional Parameters vous permet d’ajouter ou d’adapter d’autres paramètres postgresql.conf qui ne sont pas exposés dans l’UI. Saisissez chaque paramètre à la ligne, au format nom_paramètre = valeur.

Application des modifications

Après avoir adapté la configuration, cliquez sur le bouton Enregistrer en bas de page. ServBay applique automatiquement vos changements. La majorité des paramètres prennent effet immédiatement. Dans les rares cas nécessitant un redémarrage du service PostgreSQL, ServBay vous indiquera la marche à suivre.

Modification manuelle des fichiers de configuration (déconseillée pour les réglages permanents)

Comme expliqué précédemment, l’édition manuelle des fichiers de configuration n’est pas recommandée pour la gestion conventionnelle, car les modifications risquent d’être écrasées par l’UI de ServBay. Néanmoins, connaître la localisation et la structure des fichiers peut aider à mieux comprendre la configuration de bas niveau de PostgreSQL.

WARNING

L’édition manuelle ne doit servir qu’au dépannage temporaire ou à des investigations avancées. ServBay recommande vivement de privilégier l’interface graphique pour garantir la persistance et la cohérence de vos réglages. Les fichiers et leurs chemins peuvent être réinitialisés suite à la gestion automatique ServBay.

Emplacement des fichiers de configuration

Les fichiers principaux de configuration PostgreSQL dans ServBay sont postgresql.conf et pg_hba.conf. Selon la version de PostgreSQL, ils sont généralement situés à :

• postgresql.conf : /Applications/ServBay/etc/postgresql/<version>/postgresql.conf
• pg_hba.conf : /Applications/ServBay/etc/postgresql/<version>/pg_hba.conf

Notez que la documentation initiale fait référence à /db/postgresql/16/pg_hba.conf, ce qui peut correspondre à un chemin interne ou obsolète. Désormais, c’est principalement le dossier /Applications/ServBay/etc qui est utilisé et géré par l’UI de ServBay. Si vous effectuez une modification manuelle, soyez vigilant sur la localisation effective pour garantir la cohérence avec l’interface graphique.

Exemples de paramètres courants

Vous trouverez ci-dessous quelques exemples d’options courantes à retrouver ou personnaliser dans les fichiers postgresql.conf et pg_hba.conf. Utilisez un éditeur de texte (VS Code, Sublime Text, Nano, etc.) et veillez à disposer des droits administrateur pour modifier ces fichiers.

postgresql.conf

postgresql.conf est le fichier principal de configuration du serveur PostgreSQL, déterminant la plupart de ses comportements.

# Adresse(s) d’écoute : interface(s) réseau surveillées par le serveur. '*' signifie toutes les interfaces.
listen_addresses = '*'

# Numéro de port : port réseau écouté par le serveur. L’assignation standard est 5432.
port = 5432

# Nombre maximal de connexions : limite le nombre de clients connectables simultanément.
max_connections = 100

# Taille du buffer partagé : quantité de mémoire dédiée au cache partagé des données.
shared_buffers = 128MB

# Répertoire des logs : emplacement des fichiers journaux.
log_directory = 'log'

# Format de nommage des logs : motif de nom de fichier log PostgreSQL.
log_filename = 'postgresql-%Y-%m-%d.log'

# Activation des requêtes lentes : journalisation des requêtes dépassant un certain seuil (en millisecondes).
# Utilisez un entier positif ; par exemple, 2000 signifie toutes les requêtes dépassant 2 secondes.
# Valeur -1 pour désactiver le log des requêtes lentes.
log_min_duration_statement = 2000

pg_hba.conf

Le fichier pg_hba.conf (Host-Based Authentication) définit les méthodes d’authentification et les droits d’accès pour chaque type de connexion.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# Autoriser les connexions locales via socket Unix, méthode trust (pas de mot de passe requis).
# "local" concerne uniquement les connexions par socket Unix
local   all             all                                     trust

# Autoriser toutes les adresses IPv4 à se connecter à distance via TCP/IP en authentifiant par mot de passe md5.
# Connexions locales IPv4 :
host    all             all             0.0.0.0/0               md5

# Autoriser une plage d’adresses IPv4 spécifiques (ex : sous-réseau 192.168.1.0/24) à se connecter à distance en md5.
# Connexions locales IPv4 pour un sous-réseau particulier :
# host    all             all             192.168.1.0/24          md5

Lorsque vous modifiez pg_hba.conf, prenez soin de bien comprendre la signification de chaque colonne (TYPE, DATABASE, USER, ADDRESS, METHOD). Une configuration incorrecte peut empêcher tout accès ou exposer la base à des failles de sécurité.

Application des modifications manuelles

Après modification manuelle des fichiers de configuration, il est nécessaire de redémarrer le service PostgreSQL pour prendre en compte les changements.

Redémarrage via l’interface ServBay

1. Ouvrez l’interface de gestion ServBay.
2. Dans la barre de navigation à gauche, cliquez sur Base de données.
3. Repérez PostgreSQL et sélectionnez la version souhaitée.
4. Depuis cette page ou via la liste des “paquets”/“services” de la page principale, localisez le service PostgreSQL correspondant et cliquez sur Redémarrer.

Redémarrage via l’outil en ligne de commande servbayctl

Le CLI ServBay, servbayctl, permet également de gérer et de redémarrer PostgreSQL facilement :

servbayctl restart postgresql <version>

Remplacez <version> par le numéro de version réellement utilisé, par exemple 16.

Conclusion

ServBay met à disposition une interface graphique simple et puissante pour adapter les paramètres de PostgreSQL – il s’agit de la méthode privilégiée, évitant les problèmes d’écrasement inhérents à l’édition manuelle. L’UI de ServBay vous permet de modifier rapidement les adresses d’écoute, ports, nombre de connexions simultanées et visualiser les identifiants par défaut de la base. Pour des besoins avancés ou ponctuels, il reste possible de modifier à la main les fichiers de configuration postgresql.conf et pg_hba.conf situés dans /Applications/ServBay/etc/postgresql/<version>. Pour toute modification, un redémarrage du service PostgreSQL (par l’UI ServBay ou l’utilitaire servbayctl) est généralement nécessaire.

Maîtriser ces options de configuration et leurs modes d’application vous permettra d’adapter précisément votre environnement PostgreSQL dans ServBay selon vos besoins de développement.