PostgreSQL-databaseconfiguratie wijzigen in ServBay

ServBay biedt macOS-ontwikkelaars een krachtige lokale webontwikkelomgeving met geïntegreerde PostgreSQL-database. In dit artikel lees je stap voor stap hoe je de PostgreSQL-instellingen binnen ServBay wijzigt, via de aanbevolen grafische interface én de handmatige (tijdelijke) bewerkingsmethode van configuratiebestanden.

Afhankelijk van de geïnstalleerde PostgreSQL-versie in ServBay, bevinden de belangrijkste configuratiebestanden zich doorgaans in de map /Applications/ServBay/etc/postgresql/<versie>. Voorbeeld: voor PostgreSQL 16 is de configuratie te vinden onder /Applications/ServBay/etc/postgresql/16.

Belangrijk

ServBay beheert de meeste configuraties via haar grafische gebruikersinterface (UI) en genereert daarbij automatisch de corresponderende configuratiebestanden. Het wordt sterk aangeraden om het aanpassen van instellingen uitsluitend via de ServBay UI te doen. Directe handmatige aanpassingen in het configuratiebestand kunnen bij het volgende beheer of update door ServBay overschreven worden. Handmatig bewerken is enkel geschikt voor tijdelijk testen of gevorderde gebruikers die diepgaande kennis van de onderliggende structuur hebben. Gebruik dit niet voor permanente of productie-instellingen.

Configuratie aanpassen via de ServBay-interface (Aanbevolen)

ServBay biedt een intuïtieve grafische beheertool. Dit is de eenvoudigste en aanbevolen methode om je PostgreSQL-instellingen aan te passen. Wijzigingen via deze interface worden automatisch toegepast en zijn meestal direct actief, zonder dat je de service apart hoeft te herstarten (tenzij ServBay anders meldt).

Stappenplan

1. Open de ServBay-applicatie.
2. Kies Database in de linkernavigatie.
3. Zoek in de database-lijst naar PostgreSQL en klik op de versie die je wilt configureren.
4. Je komt nu op het configuratiescherm van PostgreSQL, met alle details van de geselecteerde versie en diverse opties.

Beschikbare Instellingen

Op dit scherm worden standaard de PostgreSQL-gebruikersnaam en het wachtwoord getoond die ServBay voor je heeft ingesteld. Verder kun je direct een aantal veelgebruikte parameters wijzigen:

• Luisterende adressen (listen_addresses): Bepaalt op welke netwerkinterfaces PostgreSQL luistert. Standaard ingesteld op * (alle adressen).
• Poort (port): Het netwerkpoortnummer waarop PostgreSQL luistert. De standaardpoort is 5432 (let op: anders dan MySQL/MariaDB: 3306).
• Maximaal aantal verbindingen (max_connections): Het maximum aantal gelijktijdige clientverbindingen met de database.
• Werkgeheugen (work_mem): De hoeveelheid geheugen per query (voor sorteren en hashtabellen).

Daarnaast kun je in het gedeelte Additional Parameters direct aanvullende postgresql.conf-instellingen toevoegen die niet expliciet in de UI vermeld staan. Vul per regel een parameter en waarde in als parameter = waarde.

Wijzigingen Toepassen

Klik na het aanpassen van de instellingen onderaan het scherm op Opslaan. ServBay zal de aanpassingen automatisch doorvoeren. Meestal zijn wijzigingen direct van kracht. In zeldzame gevallen is een herstart van de PostgreSQL-service nodig — ServBay zal dit aangeven indien vereist.

Handmatig configuratiebestanden aanpassen (niet aanbevolen voor permanent gebruik)

Zoals hierboven beschreven is het handmatig wijzigen van de configuratiebestanden niet de aanbevolen werkmethode, omdat ServBay-UI-instellingen je aanpassingen later kunnen overschrijven. Kennis van bestandspaden en de opbouw kan echter nuttig zijn voor inzicht in de onderliggende PostgreSQL-configuratie.

WARNING

Handmatige configuratie is alleen bedoeld voor tijdelijke troubleshooting of geavanceerde probleemoplossing. ServBay raadt aan altijd de UI te gebruiken voor aanpassingen om consistentie en duurzaamheid van je instellingen te garanderen. Bestanden kunnen door de ServBay-architectuur namelijk automatisch weer worden teruggezet.

Locatie van Configuratiebestanden

De primaire configuratiebestanden van PostgreSQL in ServBay zijn postgresql.conf en pg_hba.conf. Het pad hangt af van de versie en is doorgaans:

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

Let op: Verwijzingen naar bijvoorbeeld /db/postgresql/16/pg_hba.conf komen vaker voor in interne processen of bij oudere versies, maar de ServBay-UI beheert de configuratie hoofdzakelijk onder /Applications/ServBay/etc. Controleer bij handmatige edits dus altijd de actuele paden. Voor consistentie met het UI-beheer is /Applications/ServBay/etc/postgresql/<versie> de betrouwbaarste locatie.

Voorbeelden van veelvoorkomende instellingen

Hieronder staan enkele typische instellingen uit postgresql.conf en pg_hba.conf. Gebruik een teksteditor met beheerdersrechten (zoals VS Code, Sublime Text, Nano) voor het aanpassen.

postgresql.conf

postgresql.conf is het hoofdbestand voor serverinstellingen van PostgreSQL.

# Luisterende adressen: op welke interfaces luistert de server? '*' = alle interfaces.
listen_addresses = '*'

# Poortnummer: het poortnummer waarop de server luistert. Standaard is 5432.
port = 5432

# Maximaal aantal verbindingen: het maximum aantal gelijktijdige clients.
max_connections = 100

# Grootte van gedeeld geheugenbuffer: hoeveelheid geheugen voor databasecaching.
shared_buffers = 128MB

# Logmap: locatie voor het opslaan van logbestanden.
log_directory = 'log'

# Logbestandsnaam schema: naamgevingspatroon voor logbestanden.
log_filename = 'postgresql-%Y-%m-%d.log'

# Langzame querylog: logt queries die langer duren dan ingestelde milliseconden.
# Stel een positief getal in, bijvoorbeeld 2000 = log queries langer dan 2 seconden.
# -1 schakelt logging van langzame queries uit.
log_min_duration_statement = 2000

pg_hba.conf

Het bestand pg_hba.conf ("Host-Based Authentication") regelt hoe en wie verbinding mag maken met de PostgreSQL-database.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# Toestaan van lokale verbinding via Unix-socket zonder wachtwoord (trust).
# "local" is voor alleen Unix socket-verbindingen.
local   all             all                                     trust

# Sta alle IPv4-adressen toe voor externe verbindingen via TCP/IP, met md5-wachtwoordverificatie.
# IPv4 lokale verbindingen:
host    all             all             0.0.0.0/0               md5

# Alleen een specifiek IPv4-subnet (bijvoorbeeld 192.168.1.0/24) toegang geven via TCP/IP, met md5-verificatie.
# IPv4 verbindingen vanuit een specifiek subnet:
# host    all             all             192.168.1.0/24          md5

Let op: begrijp de betekenis van elke kolom (TYPE, DATABASE, USER, ADDRESS, METHOD). Foutieve instellingen kunnen verbinden onmogelijk maken of tot beveiligingsrisico’s leiden.

Handmatig gewijzigde instellingen toepassen

Na het wijzigen van de configuratiebestanden moet je PostgreSQL herstarten voordat aanpassingen effect hebben.

Herstarten via de ServBay-interface

1. Open het ServBay-beheer.
2. Navigeer links naar Database.
3. Selecteer PostgreSQL en klik op de juiste versie.
4. Zoek in het “Pakketten”-/“Diensten”-overzicht de PostgreSQL-service van de betreffende versie en klik op Herstart.

Herstarten met de servbayctl commandlinetool

Met de ServBay CLI-tool servbayctl beheer je eenvoudig services, inclusief het herstarten van PostgreSQL:

servbayctl restart postgresql <versie>

Vervang <versie> door het versienummer van jouw PostgreSQL-installatie, bijvoorbeeld 16.

Samenvatting

ServBay biedt een gebruiksvriendelijke en veilige UI voor het wijzigen van je PostgreSQL-instellingen; dit is doorgaans de beste keus en voorkomt dat handmatige aanpassingen per ongeluk overschreven worden. Via de ServBay-UI kun je gangbare instellingen als luisterende adressen, poort en verbindingslimiet aanpassen, en ook de standaard databasegegevens inzien. Bij tijdelijk of geavanceerd gebruik kun je terecht in de configuratiebestanden postgresql.conf en pg_hba.conf onder /Applications/ServBay/etc/postgresql/<versie>. Welke methode je ook kiest: meestal is een herstart vereist voor de wijzigingen ingaan, wat eenvoudig gaat via de UI of via het servbayctl-commando.

Door deze instellingen en methodes te begrijpen, kun je de PostgreSQL-database in ServBay optimaal afstemmen op je ontwikkelwensen.