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.

• 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

• 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.

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é.

• 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.

• 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 ou C:\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.

• 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

• 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

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

• 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 ou C:\ServBay\db\acme

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 :

1. Naviguez vers le dossier de configuration : Utilisez l’invite de commande adaptée à votre système.

   macOS (Terminal, iTerm2, etc.) :

   # 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

   Windows (PowerShell ou Command Prompt) :

   # 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

2. Lister les fichiers : Affichez la liste des fichiers du dossier :

   macOS :

   ls

   Windows :

   # PowerShell
   Get-ChildItem
   # Ou forme abrégée
   ls
   
   # Command Prompt
   dir

3. Voir le contenu des fichiers : Utilisez un éditeur ou visualiseur de texte (à consulter seulement, ne sauvegardez rien) :

   macOS :

   # 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

   Windows :

   # 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

4. Redé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 :

   # 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

   Windows :

   # 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

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 ou C:\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, avec C:\ServBay\db et C:\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.