Locatie en beheer van ServBay-configuratiebestanden

ServBay is een krachtige lokale webontwikkelomgeving. De kern ligt in de flexibele configuratie van verschillende softwarepakketten, zoals webservers, databases en taalruntimes. Om het beheer eenvoudig te houden en de stabiliteit te waarborgen, worden alle configuratiebestanden op een centrale plek opgeslagen volgens een overzichtelijke mappenstructuur. In dit artikel leer je waar de configuratiebestanden van ServBay zich bevinden en hoe je deze kunt vinden en bekijken.

Belangrijk: wijzig nooit handmatig configuratiebestanden

De configuratiebestanden van ServBay worden door het programma automatisch gegenereerd op basis van je instellingen via de gebruikersinterface (UI). Wijzig NOOIT handmatig de configuratiebestanden in /Applications/ServBay/etc of andere ServBay-mappen.

Handmatige aanpassingen van configuratiebestanden kunnen worden overschreven bij ServBay-updates, het herstarten van diensten of configuratiewijzigingen in de UI, waardoor je wijzigingen verloren gaan of onvoorziene fouten ontstaan.

Voer ALLE configuratiewijzigingen uit via de grafische gebruikersinterface (UI) van ServBay of het daarvoor bestemde commando-regelprogramma, zodat je wijzigingen blijvend zijn en het systeem stabiel blijft. De paden in dit artikel zijn bedoeld om je inzicht in de interne structuur van ServBay te vergroten of ter hulpmiddel bij het oplossen van problemen.

Overzicht van de mappenstructuur

De configuratiebestanden van ServBay zijn voornamelijk geordend in een aantal belangrijke hoofdmappen, gesorteerd op pakketnaam en versie:

• /Applications/ServBay/etc: Dit is de belangrijkste map met configuratiebestanden van ServBay. Hierin vind je bijna alle instellingen voor webservers (zoals Nginx, Caddy, Apache), taalruntimes (zoals php.ini voor PHP), databases (zoals configuratiefragmenten voor MySQL/MariaDB) en andere diensten (zoals Redis, Memcached).
• /Applications/ServBay/db: Deze map bevat hoofdzakelijk databestanden van databases, maar soms ook specifieke configuratiebestanden, bijvoorbeeld toegangscontrolebestanden van PostgreSQL.
• /Applications/ServBay/package/common: Hier staan gedeelde pakketten zoals OpenSSL; de configuratiebestanden van die pakketten vind je ook hier.

Detail: locaties van configuratiebestanden per pakket

Hieronder enkele voorbeelden voor veelgebruikte pakketten en hun configuratiebestanden in ServBay:

Webservers

Configuratiebestanden van webservers bevinden zich doorgaans in /Applications/ServBay/etc, met per pakket een eigen submap. ServBay ondersteunt meerdere versies naast elkaar, dus de configuraties zijn verder per versie gesplitst.

• Nginx: Hoofdmap configuratiebestanden: /Applications/ServBay/etc/nginx Voorbeeldpad voor Nginx versie 1.25:

  /Applications/ServBay/etc/nginx/1.25/nginx.conf

  Andere bijbehorende configuraties (zoals website- of SSL-instellingen) vind je meestal in deze map of submappen.

• Caddy: Hoofdmap configuratiebestanden: /Applications/ServBay/etc/caddy Standaard configuratiebestand:

  /Applications/ServBay/etc/caddy/Caddyfile

• Apache: Hoofdmap configuratiebestanden: /Applications/ServBay/etc/apache Voorbeeldpad voor Apache versie 2.4:

  /Applications/ServBay/etc/apache/2.4/httpd.conf

  Virtuele host- en aanvullende configuraties vind je doorgaans in de submap extra.

Taalomgevingen

Configuratiebestanden voor verschillende taalruntimes (zoals PHP, Python, Node.js, Go, Java, etc.) zijn meestal te vinden in /Applications/ServBay/etc, gestructureerd op taal en versie.

• PHP: Hoofdmap configuratiebestanden: /Applications/ServBay/etc/php Voorbeeld voor PHP versie 8.2 (php.ini):

  /Applications/ServBay/etc/php/8.2/php.ini

  Configuratiebestanden voor PHP-FPM zijn meestal ook te vinden in dezelfde versie-map.

• Python: Python wordt doorgaans geconfigureerd via omgevingsvariabelen of projectbestanden. ServBay’s Python-runtime vind je in /Applications/ServBay/package/python/{version}/bin; globale instellingen worden zelden via /etc beheerd.

• Node.js, Go, Java, Ruby, Rust, .NET: Net als bij Python worden deze talen vooral geconfigureerd via het project, variabelen of eigen toolchains. ServBay biedt deze omgevingen/SDK’s aan, maar beheert geen globale configuratiebestanden in /Applications/ServBay/etc.

Databases

Configuratiebestanden van databases zijn verspreid over /Applications/ServBay/etc en /Applications/ServBay/db.

• MySQL / MariaDB: Hoofdmap configuratiebestanden: /Applications/ServBay/etc/mysql (of /Applications/ServBay/etc/mariadb) Bijvoorbeeld voor MySQL 8.0:

  /Applications/ServBay/etc/mysql/8.0/my.cnf

  Hierin staan belangrijke parameters voor de database.

• PostgreSQL: De hoofdconfiguratiebestanden van PostgreSQL bevinden zich onder /Applications/ServBay/etc/postgresql, gesorteerd per versie. Voorbeeld voor PostgreSQL 16:

  /Applications/ServBay/etc/postgresql/16/postgresql.conf

  Klantautorisatie-bestanden zoals pg_hba.conf en pg_ident.conf vind je onder /Applications/ServBay/db/postgresql, tevens per versie:

  /Applications/ServBay/db/postgresql/16/pg_hba.conf
  /Applications/ServBay/db/postgresql/16/pg_ident.conf

• MongoDB, Redis: De configuratiebestanden van deze databases vind je doorgaans in /Applications/ServBay/etc, gesorteerd per naam en versie. Voorbeeld voor Redis:

  /Applications/ServBay/etc/redis/redis.conf

Overige diensten en gedeelde pakketten

• OpenSSL: OpenSSL-configuratie staat onder /Applications/ServBay/package/common/openssl, geordend op versie. Bijvoorbeeld voor OpenSSL 3.2:

  /Applications/ServBay/package/common/openssl/3.2/openssl.cnf

• ACME (voor automatische SSL-certificaataanvragen): ACME-configuratie en certificaten zijn meestal te vinden in /Applications/ServBay/etc/acme of /Applications/ServBay/db/acme.

Configuratiebestanden opzoeken en bekijken

Hoewel handmatig aanpassen afgeraden wordt, kun je de configuratiebestanden wel bekijken voor inzicht of bij het oplossen van problemen. Volg hiervoor deze stappen:

1. Navigeer naar de map met configuratiebestanden: Gebruik een terminal (zoals Terminal of iTerm2) om naar de juiste directory te gaan. Om de Nginx-configuratie in te zien:

   cd /Applications/ServBay/etc/nginx/

   Om de map van pg_hba.conf van PostgreSQL 16 te openen:

   cd /Applications/ServBay/db/postgresql/16

2. Toon de bestandslijst: Gebruik het ls-commando om bestanden in te zien:

   ls

3. Bekijk de inhoud van een bestand: Gebruik een viewer zoals cat, less of more, of een editor zoals vim of nano (alleen om te bekijken, SLA GEEN wijzigingen op). Bijvoorbeeld, voor nginx.conf:

   cat nginx.conf
   # Of blader met less door het bestand
   less nginx.conf

   Voor het bekijken van php.ini van PHP 8.2:

   less /Applications/ServBay/etc/php/8.2/php.ini

4. Herstart diensten (na wijzigingen via de ServBay UI): Na een wijziging via de ServBay UI moet je meestal de betreffende dienst herstarten. Gebruik hiervoor de beheerinterface of de servbayctl tool, bijvoorbeeld:

   servbayctl restart nginx -all

   Herstart PHP 8.2:

   servbayctl restart php 8.2

   Herstart alle diensten:

   servbayctl restart all

Veelgestelde vragen (FAQ)

• Vraag: Mag ik handmatig configuratiebestanden aanpassen voor geavanceerde instellingen?

  Antwoord: Dit wordt sterk afgeraden! De ServBay UI biedt opties voor de meeste gangbare instellingen. Wil je geavanceerde aanpassingen doen, raadpleeg dan de ServBay-advanced documentatie of vraag ondersteuning vanuit de community. Handmatige wijzigingen worden waarschijnlijk overschreven.

• Vraag: Hoe beheert ServBay de configuratiebestanden van pakketten met meerdere versies?

  Antwoord: Zoals hierboven beschreven, maakt ServBay voor elk pakket per versie een aparte submap in /Applications/ServBay/etc of /Applications/ServBay/db. Zo beïnvloeden de configuraties van verschillende versies elkaar niet.

• Vraag: Wat moet ik doen als ik per ongeluk een configuratiebestand verwijder of beschadig?

  Antwoord: ServBay genereert deze bestanden meestal automatisch opnieuw vanaf sjablonen op basis van jouw instellingen. Maak een willekeurige kleine wijziging aan je pakket via de UI, waarna ServBay probeert je configuratiebestanden te herstellen. In uitzonderlijke gevallen, probeer het pakket te resetten of neem contact op met ServBay-support.

Samenvatting

ServBay beheert configuratiebestanden op een centrale, gestructureerde wijze, voornamelijk in de map /Applications/ServBay/etc, aangevuld met /Applications/ServBay/db en /Applications/ServBay/package/common. Deze structuur maakt automatisch beheer makkelijker en houdt het overzichtelijk voor ontwikkelaars.

Inzicht in deze bestandslocaties helpt je de werking van ServBay beter te begrijpen en storingen te verhelpen. Nogmaals: voer alle configuratiewijzigingen uitsluitend uit via de officiële ServBay-tools of -UI, en bewerk NOOIT rechtstreeks configuratiebestanden, om je ServBay-omgeving stabiel en betrouwbaar te houden.