Emplacement et gestion des fichiers de configuration ServBay
ServBay, un environnement local puissant pour le développement web, repose sur la configuration flexible d’une multitude de paquets (serveurs web, bases de données, langages, etc.). Afin de faciliter la gestion et garantir la stabilité, ServBay centralise les fichiers de configuration de chaque paquet en suivant une structure de dossier claire. Ce guide détaille où trouver les fichiers de configuration ServBay et comment les consulter.
Avis important : ne modifiez jamais directement les fichiers de configuration
Les fichiers de configuration de ServBay sont générés automatiquement par l’application en fonction de vos paramètres (via l’interface graphique). Ne modifiez pas manuellement les fichiers dans le dossier de configuration ServBay.
- macOS :
/Applications/ServBay/etc
- Windows :
C:\ServBay\etc
Toute modification directe risque d’être écrasée lors d’une mise à jour de ServBay, lors du redémarrage des services ou après un changement via l’UI, entraînant la perte de vos réglages manuels ou des erreurs imprévues.
Effectuez systématiquement vos changements via l’interface graphique de ServBay ou les outils en ligne de commande officiels. Les chemins de fichiers listés servent à mieux comprendre la structure interne ou pour des besoins de diagnostic uniquement.
Vue d’ensemble de la structure des dossiers
Les fichiers de configuration ServBay sont principalement organisés dans ces dossiers centraux, classés par paquet et par version :
Dossier principal :
- macOS :
/Applications/ServBay/etc
- Windows :
C:\ServBay\etc
Il s’agit du dossier principal contenant la majorité des fichiers de configuration des serveurs web (Nginx, Caddy, Apache), des langages (fichiers php.ini
pour PHP), des bases de données (MySQL, MariaDB), et d’autres services (Redis, Memcached).
Dossier des bases de données :
- macOS :
/Applications/ServBay/db
- Windows :
C:\ServBay\db
Ce dossier héberge principalement les fichiers de données des bases de données, et parfois certains fichiers propres à la configuration de PostgreSQL, comme les fichiers de contrôle d’accès.
Dossier des paquets communs :
- macOS :
/Applications/ServBay/package/common
- Windows :
C:\ServBay\package\common
Ce dossier contient les paquets partagés, tels qu’OpenSSL, ainsi que leur configuration.
Emplacement détaillé des fichiers de configuration par paquet
Voici où sont stockés les fichiers des paquets couramment utilisés dans ServBay :
Serveurs web
Les configurations des serveurs web se trouvent généralement dans le dossier principal, sous leur nom, puis par version.
Nginx : Dossier principal :
- macOS :
/Applications/ServBay/etc/nginx
- Windows :
C:\ServBay\etc\nginx
Exemple pour Nginx version 1.25 :
- macOS :
/Applications/ServBay/etc/nginx/1.25/nginx.conf
- Windows :
C:\ServBay\etc\nginx\1.25\nginx.conf
Les autres fichiers relatifs à Nginx (sites, SSL, etc.) se trouvent dans ce dossier ou sous-dossiers.
- macOS :
Caddy : Dossier principal :
- macOS :
/Applications/ServBay/etc/caddy
- Windows :
C:\ServBay\etc\caddy
Fichier principal :
- macOS :
/Applications/ServBay/etc/caddy/Caddyfile
- Windows :
C:\ServBay\etc\caddy\Caddyfile
- macOS :
Apache : Dossier principal :
- macOS :
/Applications/ServBay/etc/apache
- Windows :
C:\ServBay\etc\apache
Exemple pour Apache 2.4 :
- macOS :
/Applications/ServBay/etc/apache/2.4/httpd.conf
- Windows :
C:\ServBay\etc\apache\2.4\httpd.conf
Les configurations des hôtes virtuels se trouvent en général dans le sous-dossier
extra
.- macOS :
Langages et runtimes
Les configurations des environnements de langages sont organisées par nom et version dans le dossier principal.
PHP : Dossier principal :
- macOS :
/Applications/ServBay/etc/php
- Windows :
C:\ServBay\etc\php
Exemple pour PHP 8.2 :
- macOS :
/Applications/ServBay/etc/php/8.2/php.ini
- Windows :
C:\ServBay\etc\php\8.2\php.ini
Les fichiers de configuration PHP-FPM se trouvent également dans ce dossier versionné.
- macOS :
Python : Python est généralement configuré via des variables d’environnement ou des fichiers projet. Les exécutables fournis par ServBay se trouvent ici :
- macOS :
/Applications/ServBay/package/python/{version}/bin
- Windows :
C:\ServBay\package\python\{version}\bin
Les configurations globales de Python ne passent généralement pas par le dossier principal ServBay.
- macOS :
Node.js, Go, Java, Ruby, Rust, .NET : Ces langages s’appuient, comme Python, sur des paramètres projet ou environnement, ou leur propre outil. ServBay propose le runtime ou l’SDK mais les fichiers de configuration globaux ne sont pas centralisés.
Bases de données
Les fichiers de configuration des bases de données sont répartis dans le dossier principal et le dossier de données.
MySQL / MariaDB : Dossier principal :
- macOS :
/Applications/ServBay/etc/mysql
ou/Applications/ServBay/etc/mariadb
- Windows :
C:\ServBay\etc\mysql
ouC:\ServBay\etc\mariadb
Exemple pour MySQL 8.0 :
- macOS :
/Applications/ServBay/etc/mysql/8.0/my.cnf
- Windows :
C:\ServBay\etc\mysql\8.0\my.cnf
Ce fichier contient les paramètres essentiels de la base.
- macOS :
PostgreSQL : Principaux fichiers dans :
- macOS :
/Applications/ServBay/etc/postgresql
- Windows :
C:\ServBay\etc\postgresql
Exemple pour PostgreSQL 16 :
- macOS :
/Applications/ServBay/etc/postgresql/16/postgresql.conf
- Windows :
C:\ServBay\etc\postgresql\16\postgresql.conf
Les fichiers d’authentification (
pg_hba.conf
,pg_ident.conf
) sont dans le dossier de la base de données :- macOS :
/Applications/ServBay/db/postgresql/16/pg_hba.conf
- macOS :
/Applications/ServBay/db/postgresql/16/pg_ident.conf
- Windows :
C:\ServBay\db\postgresql\16\pg_hba.conf
- Windows :
C:\ServBay\db\postgresql\16\pg_ident.conf
- macOS :
MongoDB, Redis : Ces bases stockent leurs fichiers de configuration dans le dossier principal, triés par nom et version :
- macOS :
/Applications/ServBay/etc
- Windows :
C:\ServBay\etc
Exemple pour Redis :
- macOS :
/Applications/ServBay/etc/redis/redis.conf
- Windows :
C:\ServBay\etc\redis\redis.conf
- macOS :
Autres services et paquets communs
OpenSSL : Configurations dans le dossier des paquets communs, par version :
- macOS :
/Applications/ServBay/package/common/openssl
- Windows :
C:\ServBay\package\common\openssl
Exemple pour OpenSSL 3.2 :
- macOS :
/Applications/ServBay/package/common/openssl/3.2/openssl.cnf
- Windows :
C:\ServBay\package\common\openssl\3.2\openssl.cnf
- macOS :
ACME (pour les certificats SSL automatiques) : Configurations et certificats dans :
- macOS :
/Applications/ServBay/etc/acme
ou/Applications/ServBay/db/acme
- Windows :
C:\ServBay\etc\acme
ouC:\ServBay\db\acme
- macOS :
Rechercher et consulter les fichiers de configuration
Même si l’édition directe est déconseillée, il peut être utile de consulter les fichiers pour vérifier un réglage ou pour le diagnostic. Voici comment s’y prendre :
Naviguez vers le dossier de configuration : Utilisez l’invite de commande adaptée à votre système.
macOS (Terminal, iTerm2, etc.) :
bash# Accéder au dossier des configurations Nginx cd /Applications/ServBay/etc/nginx/ # Accéder au dossier du pg_hba.conf de PostgreSQL 16 cd /Applications/ServBay/db/postgresql/16
1
2
3
4
5Windows (PowerShell ou Command Prompt) :
powershell# Accéder au dossier des configurations Nginx cd C:\ServBay\etc\nginx\ # Accéder au dossier du pg_hba.conf de PostgreSQL 16 cd C:\ServBay\db\postgresql\16
1
2
3
4
5Lister les fichiers : Affichez la liste des fichiers du dossier :
macOS :
bashls
1Windows :
powershell# PowerShell Get-ChildItem # Ou forme abrégée ls # Command Prompt dir
1
2
3
4
5
6
7Voir le contenu des fichiers : Utilisez un éditeur ou visualiseur de texte (à consulter seulement, ne sauvegardez rien) :
macOS :
bash# Lire le fichier nginx.conf cat nginx.conf # Ou paginer avec less less nginx.conf # Lire le php.ini de PHP 8.2 less /Applications/ServBay/etc/php/8.2/php.ini
1
2
3
4
5
6
7Windows :
powershell# PowerShell - Lire le fichier nginx.conf Get-Content nginx.conf # Ou paginer avec more more nginx.conf # Lire le php.ini de PHP 8.2 Get-Content C:\ServBay\etc\php\8.2\php.ini | more # Command Prompt type nginx.conf more nginx.conf
1
2
3
4
5
6
7
8
9
10
11Redémarrer les services (après un changement fait via ServBay UI) : Après une modification via l’UI, redémarrez le service concerné. Utilisez l’interface ServBay ou l’outil en ligne de commande
servbayctl
.macOS :
bash# Redémarrage du service Nginx servbayctl restart nginx -all # Redémarrage du service PHP 8.2 servbayctl restart php 8.2 # Redémarrage de tous les services servbayctl restart all
1
2
3
4
5
6
7
8Windows :
powershell# Redémarrage du service Nginx servbayctl.exe restart nginx -all # Redémarrage du service PHP 8.2 servbayctl.exe restart php 8.2 # Redémarrage de tous les services servbayctl.exe restart all
1
2
3
4
5
6
7
8
Foire aux questions (FAQ)
Q : Puis-je modifier manuellement un fichier de configuration pour tester certains réglages avancés ?
R : Cela est fortement déconseillé. L’interface ServBay offre la plupart des options courantes. Pour des personnalisations non prises en charge par l’UI, consultez la documentation avancée ou la communauté ServBay. Les modifications manuelles risquent d’être écrasées.
Q : Comment ServBay gère-t-il les fichiers de configuration multi-version ?
R : Comme expliqué, ServBay crée un sous-dossier pour chaque version de chaque paquet dans les dossiers de configuration (
/Applications/ServBay/etc
ou/Applications/ServBay/db
sous macOS ;C:\ServBay\etc
ouC:\ServBay\db
sous Windows) pour isoler les paramètres des versions différentes.Q : Que faire si un fichier de configuration est supprimé ou corrompu par erreur ?
R : ServBay régénère les fichiers de configuration via ses modèles internes et la configuration utilisateur. En principe, faites un petit changement sur le paquet via l’UI pour forcer la régénération du fichier. En cas de problème persistant, essayez de réinitialiser le service ou contactez le support ServBay.
Conclusion
ServBay gère les fichiers de configuration de manière structurée et centralisée, offrant une organisation cohérente sur toutes les plateformes :
- macOS : principalement dans
/Applications/ServBay/etc
, avec/Applications/ServBay/db
et/Applications/ServBay/package/common
comme compléments - Windows : principalement dans
C:\ServBay\etc
, avecC:\ServBay\db
etC:\ServBay\package\common
Cette approche standardisée permet à ServBay de gérer les configurations automatiquement et facilite les diagnostics pour les développeurs.
Bien comprendre ces emplacements vous aidera à saisir le fonctionnement de ServBay et à réaliser des diagnostics efficaces. Rappel important : effectuez vos changements de configuration exclusivement via l’interface officielle ou les outils ServBay pour garantir la fiabilité et la stabilité de votre environnement.