Locatie en beheer van ServBay configuratiebestanden

ServBay is een krachtige lokale webontwikkelomgeving, waarvan het hart gevormd wordt door flexibele configuratie van verschillende softwarepakketten (zoals webservers, databases, runtime-omgevingen enzovoorts). Om eenvoudig beheer en een stabiel systeem te garanderen, bewaart ServBay alle configuratiebestanden centraal en volgt een duidelijke directorystructuur. In dit artikel lees je waar de ServBay-configuratiebestanden te vinden zijn en hoe je deze belangrijke bestanden kunt opzoeken en bekijken.

Belangrijk: wijzig configuratiebestanden nooit handmatig

De configuratiebestanden van ServBay worden automatisch gegenereerd door de applicatie op basis van jouw instellingen via de gebruikersinterface (UI). Wijzig nooit rechtstreeks configuratiebestanden in de ServBay-directory.

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

Handmatige aanpassingen kunnen verloren gaan of onverwachte fouten veroorzaken tijdens updates van ServBay, het herstarten van services, of het wijzigen van instellingen via de UI.

Alle configuratiewijzigingen moeten altijd via de grafische interface (UI) van ServBay of het officiële CLI-hulpprogramma verlopen. Zo blijven wijzigingen behouden en blijft het systeem stabiel. Dit artikel biedt inzicht in de bestandslocaties zodat je de interne structuur begrijpt of bij het oplossen van problemen bestanden kunt inspecteren.

Overzicht van de directorystructuur

De configuratiebestanden van ServBay zijn hoofdzakelijk gecentraliseerd in een paar kernmappen en geordend per softwarepakket en versie.

Belangrijkste configuratiemap:

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

Dit is de primaire map voor de configuratiebestanden binnen ServBay. Hier vind je de meeste webserverbestanden (zoals van Nginx, Caddy, Apache), runtime-configuraties (zoals php.ini van PHP), databasefragmenten (voor MySQL, MariaDB) en configuraties voor andere services (zoals Redis en Memcached).

Database-map:

• macOS: /Applications/ServBay/db
• Windows: C:\ServBay\db

Deze map slaat voornamelijk de databasegegevens op, maar bevat soms ook databasespecifieke configuratiebestanden, bijvoorbeeld de toegangscontrole van PostgreSQL.

Directory voor algemene pakketten:

• macOS: /Applications/ServBay/package/common
• Windows: C:\ServBay\package\common

Hier staan algemene pakketten, zoals OpenSSL. De configuratiebestanden van OpenSSL vind je hier terug.

Gedetailleerde locatie van configuratiebestanden per pakket

Hieronder vind je voorbeelden van waar je de configuratiebestanden van veelgebruikte pakketten in ServBay kunt vinden:

Webservers

De configuratiebestanden van webservers staan doorgaans in de hoofdmap, geordend op naam en versie.

• Nginx: Hoofdmappen configuratie:

  • macOS: /Applications/ServBay/etc/nginx
  • Windows: C:\ServBay\etc\nginx

  Voorbeeldpad voor Nginx versie 1.25:

  • macOS: /Applications/ServBay/etc/nginx/1.25/nginx.conf
  • Windows: C:\ServBay\etc\nginx\1.25\nginx.conf

  Overige relevante configuratiebestanden (zoals site- of SSL-instellingen) vind je in deze map of submappen.

• Caddy: Hoofdmappen configuratie:

  • macOS: /Applications/ServBay/etc/caddy
  • Windows: C:\ServBay\etc\caddy

  Belangrijkste configuratiebestand:

  • macOS: /Applications/ServBay/etc/caddy/Caddyfile
  • Windows: C:\ServBay\etc\caddy\Caddyfile

• Apache: Hoofdmappen configuratie:

  • macOS: /Applications/ServBay/etc/apache
  • Windows: C:\ServBay\etc\apache

  Voor Apache versie 2.4:

  • macOS: /Applications/ServBay/etc/apache/2.4/httpd.conf
  • Windows: C:\ServBay\etc\apache\2.4\httpd.conf

  Configuraties voor virtual hosts vind je doorgaans onder de submap extra.

Talen runtime-omgevingen

De configuratiebestanden voor talenruntimes (zoals PHP, Python, Node.js, Go, Java, enzovoort) staan ook gegroepeerd in de hoofdmap, per taal en versie.

• PHP: Hoofdmappen configuratie:

  • macOS: /Applications/ServBay/etc/php
  • Windows: C:\ServBay\etc\php

  Voorbeeldpad voor PHP 8.2 php.ini:

  • macOS: /Applications/ServBay/etc/php/8.2/php.ini
  • Windows: C:\ServBay\etc\php\8.2\php.ini

  Ook configuraties voor PHP-FPM vind je in dezelfde versiemap.

• Python: Python gebruikt doorgaans configuraties via omgevingsvariabelen of projectbestanden. De belangrijkste uitvoerbare bestanden van de Python-omgeving van ServBay vind je hier:

  • macOS: /Applications/ServBay/package/python/{version}/bin
  • Windows: C:\ServBay\package\python\{version}\bin

  Globale configuratiebestanden worden over het algemeen niet via de hoofdmap van ServBay beheerd.

• Node.js, Go, Java, Ruby, Rust, .NET: Deze talen vertrouwen meestal op projectconfiguratie, omgevingsvariabelen of hun eigen toolchain voor instellingen. ServBay voorziet deze talen enkel van de runtime of SDK — globale configuratiebestanden staan niet centraal in ServBay.

Databases

Configuratiebestanden voor databases worden verspreid opgeslagen in zowel de hoofd- als datamap.

• MySQL / MariaDB: Hoofdmappen configuratie:

  • macOS: /Applications/ServBay/etc/mysql (of /Applications/ServBay/etc/mariadb)
  • Windows: C:\ServBay\etc\mysql (of C:\ServBay\etc\mariadb)

  Voor MySQL 8.0:

  • macOS: /Applications/ServBay/etc/mysql/8.0/my.cnf
  • Windows: C:\ServBay\etc\mysql\8.0\my.cnf

  Dit bestand bevat doorgaans de belangrijkste database-instellingen.

• PostgreSQL: Globale configuratiebestanden per versie:

  • macOS: /Applications/ServBay/etc/postgresql
  • Windows: C:\ServBay\etc\postgresql

  Voor PostgreSQL 16:

  • macOS: /Applications/ServBay/etc/postgresql/16/postgresql.conf
  • Windows: C:\ServBay\etc\postgresql\16\postgresql.conf

  Authenticatiebestanden als pg_hba.conf en pg_ident.conf vind je in de datamap per versie:

  • 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: De configuratiebestanden van deze databases staan doorgaans in de hoofdmap, per naam en versie.

  • macOS: /Applications/ServBay/etc
  • Windows: C:\ServBay\etc

  Voor Redis:

  • macOS: /Applications/ServBay/etc/redis/redis.conf
  • Windows: C:\ServBay\etc\redis\redis.conf

Overige diensten en algemene softwarepakketten

• OpenSSL: Configuratiebestanden vind je onder de algemene pakketten per versie:

  • macOS: /Applications/ServBay/package/common/openssl
  • Windows: C:\ServBay\package\common\openssl

  Voor OpenSSL versie 3.2:

  • macOS: /Applications/ServBay/package/common/openssl/3.2/openssl.cnf
  • Windows: C:\ServBay\package\common\openssl\3.2\openssl.cnf

• ACME (voor automatische SSL-certificaat aanvraag): ACME-configuratie en certificaten staan meestal hier:

  • macOS: /Applications/ServBay/etc/acme of /Applications/ServBay/db/acme
  • Windows: C:\ServBay\etc\acme of C:\ServBay\db\acme

Configuratiebestanden opzoeken en bekijken

Hoewel handmatige bewerking afgeraden wordt, wil je soms toch de inhoud van configuratiebestanden bekijken voor troubleshooting of inzicht. Zo geef je bestanden weer:

1. Navigeer naar de configuratiemap: Gebruik een commando-line tool om de juiste directory te openen.

   macOS (gebruik Terminal of iTerm2):

   # Bekijk de Nginx-configuratiemap
   cd /Applications/ServBay/etc/nginx/
   
   # Ga naar de map van PostgreSQL 16 voor pg_hba.conf
   cd /Applications/ServBay/db/postgresql/16

   Windows (gebruik PowerShell of Command Prompt):

   # Ga naar Nginx-configuratiemappen
   cd C:\ServBay\etc\nginx\
   
   # Navigeer naar PostgreSQL 16 voor pg_hba.conf
   cd C:\ServBay\db\postgresql\16

2. Toon de bestanden in de map:

   macOS:

   ls

   Windows:

   # PowerShell
   Get-ChildItem
   # Of korter:
   ls
   
   # Command Prompt
   dir

3. Bekijk de bestandsinhoud: Open bestanden enkel om te lezen, sla wijzigingen nooit op.

   macOS:

   # Bekijk Nginx's nginx.conf bestand
   cat nginx.conf
   # Of paginerend bekijken
   less nginx.conf
   
   # Bekijk PHP 8.2's php.ini bestand
   less /Applications/ServBay/etc/php/8.2/php.ini

   Windows:

   # PowerShell - bekijk nginx.conf bestand
   Get-Content nginx.conf
   # Of paginerend weergeven
   more nginx.conf
   
   # Bekijk PHP 8.2's php.ini bestand
   Get-Content C:\ServBay\etc\php\8.2\php.ini | more
   
   # Command Prompt
   type nginx.conf
   more nginx.conf

4. Herstart services (wanneer je via ServBay UI iets hebt gewijzigd): Na een wijziging via ServBay UI is het meestal nodig de betreffende service opnieuw te starten. Dit kan via de ServBay-interface of met het servbayctl commando.

   macOS:

   # Herstart Nginx
   servbayctl restart nginx -all
   
   # Herstart PHP 8.2
   servbayctl restart php 8.2
   
   # Herstart alle services
   servbayctl restart all

   Windows:

   # Herstart Nginx
   servbayctl.exe restart nginx -all
   
   # Herstart PHP 8.2
   servbayctl.exe restart php 8.2
   
   # Herstart alle services
   servbayctl.exe restart all

Veelgestelde vragen (FAQ)

• Vraag: Kan ik configuratiebestanden handmatig aanpassen om geavanceerde instellingen te testen?

  Antwoord: Dit wordt sterk afgeraden. ServBay UI biedt voor de meeste configuraties voldoende instelmogelijkheden. Voor diepgaande aanpassingen die niet via de UI kunnen, raadpleeg de geavanceerde documentatie van ServBay of vraag ondersteuning in de community. Handmatige wijzigingen worden vaak overschreven.

• Vraag: Hoe beheert ServBay configuratiebestanden voor meerdere pakketversies?

  Antwoord: Zoals beschreven, maakt ServBay in de configuratiemappen (macOS: /Applications/ServBay/etc of /Applications/ServBay/db; Windows: C:\ServBay\etc of C:\ServBay\db) aparte submappen per pakket en versie. Zo blijven configuraties voor verschillende versies gescheiden.

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

  Antwoord: ServBay genereert configuratiebestanden automatisch op basis van templates en jouw instellingen. In de meeste gevallen kun je via de UI een (kleine) wijziging maken aan de configuratie van het betreffende pakket, waarna ServBay het bestand opnieuw aanmaakt. In uitzonderlijke gevallen moet je een reset uitvoeren of contact opnemen met ServBay support.

Samenvatting

ServBay beheert configuratiebestanden op een gecentraliseerde en gestructureerde manier, ongeacht het besturingssysteem:

• macOS: hoofdzakelijk in de map /Applications/ServBay/etc, aangevuld met /Applications/ServBay/db en /Applications/ServBay/package/common
• Windows: hoofdzakelijk in C:\ServBay\etc, aangevuld met C:\ServBay\db en C:\ServBay\package\common

Deze uniforme structuur maakt het mogelijk ServBay-configuratiebestanden automatisch te beheren en vergemakkelijkt het terugvinden en oplossen van problemen.

Inzicht in bestandslocaties is waardevol voor het begrijpen van ServBay en voor troubleshooting. Let op: breng configuratiewijzigingen uitsluitend aan via de officiële interface of tools van ServBay; wijzig nooit rechtstreeks de configuratiebestanden. Dit garandeert een stabiele en betrouwbare ServBay-omgeving.