Ga naar hoofdinhoud

VPS: Plausible installeren op OS

Deze handleiding is gemaakt met de volgende producten:

(Details kunnen verschillen bij producten van verschillende aanbieders, maar de hoofdconcepten blijven hetzelfde)

Introductie

Plausible is een lichtgewicht, open-source webanalyseplatform dat zonder cookies werkt en volledig voldoet aan privacyregels. Het levert belangrijke statistieken, zoals bezoekersaantallen, paginaweergaven en bezoektijd, via een overzichtelijk en intuïtief dashboard. Dankzij het gebruiksgemak, de snelle prestaties en de EU-gebaseerde infrastructuur is Plausible een moderne en privacybewuste alternatief voor Google Analytics.

Overweeg je deze service zelf te hosten? We nemen je stap voor stap mee in het installatie- en configuratieproces, inclusief alles wat je moet weten.

Vereisten

Voordat je Plausible installeert, zorg je dat je hostingomgeving aan de volgende eisen voldoet voor een soepele installatie en optimale prestaties.

HardwareMinimaalZAP-Hosting Aanbeveling
CPU1 vCPU Core4 vCPU Cores
RAM2 GB4 GB
Schijfruimte10 GB25 GB

De software vereist dat alle benodigde dependencies geïnstalleerd zijn en dat het draait op een ondersteund besturingssysteem. Controleer of je server aan de volgende eisen voldoet voordat je verder gaat met de installatie:

Dependencies: Docker

Besturingssysteem: Laatste versie van Ubuntu/Debian met ondersteuning voor Docker 26+

Zorg dat alle dependencies geïnstalleerd zijn en dat je de juiste OS-versie gebruikt om compatibiliteitsproblemen tijdens de installatie van Plausible te voorkomen.

Voorbereiding

Voordat je Plausible installeert, moet je je systeem klaarmaken. Dit betekent dat je het besturingssysteem bijwerkt naar de nieuwste versie en alle benodigde dependencies installeert. Deze voorbereidingen zorgen voor een stabiele omgeving en helpen problemen tijdens of na de installatie te voorkomen.

Systeem bijwerken

Om zeker te zijn dat je systeem draait met de nieuwste software en beveiligingsupdates, voer je eerst een systeemupdate uit. Gebruik hiervoor het volgende commando:

sudo apt update && sudo apt upgrade -y

Dit zorgt ervoor dat je systeem de laatste beveiligingspatches en softwareversies heeft voordat je verder gaat.

Dependencies installeren

Als de update klaar is, kun je de dependencies installeren.

Git

De Plausible data wordt via GitHub gedownload. Hiervoor moet Git eerst geïnstalleerd zijn. Voer het volgende commando uit:

sudo apt install git-all

Docker

Plausible wordt op je machine gedraaid in een Docker-container. Docker moet dus eerst geïnstalleerd worden. Gebruik hiervoor het volgende commando:

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

Een volledige walkthrough van het installatieproces en het gebruik van Docker vind je in onze Docker gids.

Installatie

Nu aan alle vereisten is voldaan en de voorbereidingen zijn getroffen, kun je doorgaan met het installeren van de Plausible applicatie.

Begin met het clonen van de Community Edition repository en het aanmaken van het benodigde configuratiebestand:

$ git clone -b v3.0.1 --single-branch https://github.com/Plausible/community-edition Plausible-ce

Maak vervolgens een environment-bestand (.env) aan en definieer de essentiële variabelen. De BASE_URL moet verwijzen naar het daadwerkelijke domein dat al een DNS-record heeft dat naar je server verwijst. Je moet ook een willekeurige SECRET_KEY_BASE genereren met minimaal 64 bytes:

touch .env
echo "BASE_URL=https://Plausible.example.com" >> .env
echo "SECRET_KEY_BASE=$(openssl rand -base64 48)" >> .env
echo "HTTP_PORT=80" >> .env
echo "HTTPS_PORT=443" >> .env

Controleer de inhoud van het bestand met cat .env om te bevestigen dat de waarden kloppen. De output zou er zo uit moeten zien:

BASE_URL=https://Plausible.example.com
SECRET_KEY_BASE=As0fZsJlUpuFYSthRjT5Yflg/NlxkFKPRro72xMLXF8yInZ60s6xGGXYVqml+XN1
HTTP_PORT=80
HTTPS_PORT=443

Deze standaardpoorten zorgen ervoor dat Let’s Encrypt automatisch TLS-certificaten kan uitgeven. Als je Plausible achter een reverse proxy wilt draaien, kun je deze waarden aanpassen. Maak daarnaast een compose.override.yml aan om de juiste poorten voor de Plausible-container te exposen:

cat > compose.override.yml << EOF
services:
Plausible:
ports:
- 80:80
- 443:443
EOF

Start tenslotte de benodigde services met Docker Compose:

docker compose up -d

Als de containers draaien, open je je browser op het domein dat je in BASE_URL hebt opgegeven en maak je het eerste gebruikersaccount aan.

img

Configuratie

Plausible kan geïntegreerd worden met Google Search Console om je analytics te verrijken met zoekopdrachtgegevens. Zo zie je welke zoekwoorden verkeer naar je site sturen, wat je diepere inzichten geeft in het gedrag van bezoekers.

Met een bestaand Google Cloud-account en een OAuth-client hoef je alleen je credentials (GOOGLE_CLIENT_ID en GOOGLE_CLIENT_SECRET) toe te voegen aan het .env bestand. Na opslaan herstart je de Docker-services met docker compose up -d. In het Plausible dashboard ga je naar Site Settings > Integrations om de koppeling af te ronden en de authenticatie te volgen.

Heb je nog geen OAuth-client of ben je niet bekend met het proces? De officiële Plausible Wiki biedt een uitgebreide stap-voor-stap handleiding. Hierin wordt uitgelegd hoe je een project aanmaakt in Google Cloud, de benodigde API’s activeert, een OAuth-client configureert en de gegenereerde credentials toevoegt aan Plausible: Plausible Wiki: Google Integration.

Als je Google Search Console gebruikt, kun je de Google Integratie configureren om data uit Search Console over zoektermen binnen te halen — superhandig.

Heb je al een Google Cloud-account met een OAuth-client? Plak dan simpelweg je GOOGLE_CLIENT_ID en GOOGLE_CLIENT_SECRET in het .env bestand, herstart je docker service met docker compose up -d en volg de aanwijzingen in Plausible’s Site Settings > Integrations.

Conclusie en meer bronnen

Gefeliciteerd! Je hebt Plausible nu succesvol geïnstalleerd en geconfigureerd op je VPS. We raden je ook aan om de volgende bronnen te bekijken, die je extra hulp en tips kunnen bieden tijdens je serverconfiguratie:

Heb je specifieke vragen die hier niet behandeld worden? Voor verdere vragen of hulp kun je altijd contact opnemen met onze support, die dagelijks voor je klaarstaat! 🙂