Dokploy VPS Installatiegids: Zelf-Gehost Deployment Platform

Dokploy is een open-source PaaS die het deployen van applicaties heel eenvoudig maakt. Zie het als je persoonlijke Vercel/Railway die op elke VPS draait.

Wat is Dokploy?

Dokploy neemt de saaie onderdelen van deployment over:

• Git-gebaseerde deployments — Push om te deployen
• Automatisch SSL — Let’s Encrypt integratie
• Docker native — Voer elke gecontaineriseerde app uit
• Databasesjablonen — Één-klik PostgreSQL, MySQL, Redis
• Traefik routing — Automatisch domeinbeheer
• Realtime logs — Bewaak deployments live

Dokploy vs Andere Platforms

Functie	Dokploy	Coolify	Vercel
Prijs	Gratis (VPS-kosten)	Gratis (VPS-kosten)	$20+/mo
Zelf-gehost	✅	✅	❌
Docker Compose	✅	✅	❌
Multi-server	✅	✅	❌
UI Eenvoud	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
Functies	Groeiend	Volwassen	Meest

Dokploy is nieuwer maar heeft een schonere UI en snellere installatie.

VPS Vereisten

Minimaal:

• 1 vCPU, 2GB RAM
• 25GB opslag
• Ubuntu 22.04+

Aanbevolen:

• 2 vCPU, 4GB RAM
• 50GB opslag
• Ubuntu 22.04 of Debian 12

Beste VPS voor Dokploy

Aanbieder	Plan	Specificaties	Prijs
Hostinger	KVM1	1 vCPU, 4GB RAM	$4.99/mo
Hetzner	CX21	2 vCPU, 4GB RAM	€5.39/mo
Vultr	VC2	1 vCPU, 2GB RAM	$12/mo

Installatie

Stap 1: VPS Aanmaken

1. Registreer bij Hetzner of Hostinger
2. Maak een Ubuntu 22.04 server aan
3. Voeg SSH-sleutel toe
4. Noteer het IP-adres

Stap 2: DNS Instellen

Wijs je domein toe vóór de installatie:

A    dokploy.joudomein.com      → jouw-server-ip
A    *.dokploy.joudomein.com    → jouw-server-ip

Het wildcard-record geeft elke app een subdomein.

Stap 3: Verbinding Maken met Server

ssh root@your-server-ip

# Update systeem
apt update && apt upgrade -y

Stap 4: Dokploy Installeren

Één commando doet alles:

curl -sSL https://dokploy.com/install.sh | sh

Dit installeert:

• Docker
• Dokploy applicatie
• Traefik reverse proxy
• PostgreSQL (voor Dokploy-data)

Duurt ongeveer 3-5 minuten.

Stap 5: Dashboard Openen

http://your-server-ip:3000

Maak je beheerdersaccount aan. Gebruik een sterk wachtwoord.

Stap 6: Domein & SSL Configureren

1. Ga naar Instellingen
2. Stel Serverdomein in: dokploy.joudomein.com
3. Schakel SSL/TLS in
4. Voer e-mailadres in voor Let’s Encrypt
5. Opslaan

Toegang nu via https://dokploy.joudomein.com

Applicaties Deployen

Deployen vanuit GitHub

1. Projecten → Nieuw Project
2. Voeg Applicatie toe
3. Selecteer bron: GitHub
4. Autoriseer GitHub-toegang
5. Kies repository
6. Klik op Deploy

Dokploy detecteert automatisch:

• Node.js (package.json)
• Python (requirements.txt)
• Go (go.mod)
• Dockerfile

Deployen met Docker Compose

Voor bestaande compose-projecten:

1. Maak Applicatie aan → Docker Compose
2. Plak je compose-bestand of selecteer uit repo
3. Deploy

Voorbeeldcompose:

version: '3.8'
services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"

Deployen met Dockerfile

1. Maak Applicatie aan → Dockerfile
2. Verwijs naar repo met Dockerfile
3. Dokploy bouwt en deployt

Database Instellen

PostgreSQL

1. Projecten → Selecteer project
2. Voeg Service toe → PostgreSQL
3. Stel databasenaam en wachtwoord in
4. Deploy

Verbindingsstring verschijnt in het dashboard:

postgresql://postgres:password@postgres-xxx:5432/dbname

MySQL

Zelfde proces:

1. Voeg Service toe → MySQL
2. Configureer inloggegevens
3. Deploy

Redis

1. Voeg Service toe → Redis
2. Deploy
3. Gebruik redis://redis-xxx:6379

Aangepaste Domeinen

Domein Toevoegen aan App

1. Selecteer applicatie
2. Tabblad Domeinen
3. Voeg toe: app.joudomein.com
4. SSL wordt automatisch ingericht

Doorsturen van www naar niet-www

Voeg beide domeinen toe, Dokploy handelt doorverwijzingen af:

joudomein.com
www.joudomein.com

Omgevingsvariabelen

Applicatievariabelen

1. Selecteer app → Omgeving
2. Voeg variabelen toe:

DATABASE_URL=postgresql://...
SECRET_KEY=your-secret
NODE_ENV=production

Geheimen (Versleuteld)

Voor gevoelige gegevens:

1. Instellingen → Geheimen
2. Maak geheim aan
3. Verwijzing in apps: {{SECRET_NAME}}

Deployments & Terugdraaien

Automatische Deployments

Webhooks inschakelen:

1. App-instellingen → Build
2. Schakel Auto Deploy in
3. Pushen naar main activeert herbouw

Handmatig Deployen

Klik op de knop Deploy wanneer dan ook.

Terugdraaien

1. Tabblad Deployments
2. Zoek vorige deployment op
3. Klik op Terugdraaien

Monitoring

Realtime Logs

1. Selecteer applicatie
2. Tabblad Logs
3. Stream logs in realtime

Resourcegebruik

Dashboard toont:

• CPU-gebruik per app
• Geheugenverbruik
• Schijfgebruik
• Netwerkverkeer

Gezondheidscontroles

Configureer in app-instellingen:

Health Check Path: /health
Interval: 30s
Timeout: 5s

Back-ups

Database Back-ups

1. Selecteer database
2. Back-ups → Inschakelen
3. Stel schema in
4. Configureer bestemming (S3, lokaal)

Handmatige Back-up

# Op VPS
docker exec dokploy-postgres pg_dump -U postgres > backup.sql

Volume Back-ups

Voor apps met persistente data:

docker run --rm \
  -v app_data:/data \
  -v /backup:/backup \
  alpine tar czf /backup/data.tar.gz /data

Multi-Server Instellen

Dokploy ondersteunt meerdere servers:

1. Servers → Server Toevoegen
2. Installeer Dokploy-agent op nieuwe VPS:

   curl -sSL https://dokploy.com/install-agent.sh | sh

3. Voeg servertoken toe aan Dokploy
4. Deploy apps naar specifieke servers

Gebruiksscenario’s:

• Afzonderlijke staging/productie
• Geografische spreiding
• Resource-isolatie

Veelvoorkomende Deployments

Next.js

1. Maak app aan → GitHub → Selecteer repo
2. Build-commando: npm run build
3. Startcommando: npm start
4. Poort: 3000

FastAPI

Dockerfile:

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

Statische Sites

1. Maak app aan → GitHub
2. Build: npm run build
3. Publicatiemap: dist of build
4. Dokploy serveert statische bestanden

WordPress

1. Voeg Service toe → WordPress
2. Één-klik installatie inclusief MySQL
3. Configureer domein
4. Klaar

Probleemoplossing

Deployment Mislukt

Controleer logs:

1. App → Deployments → Mislukte deployment
2. Bekijk build-logs
3. Veelvoorkomende problemen:
   • Ontbrekende afhankelijkheden
   • Poortconflict
   • Verkeerd build-commando

SSL Werkt Niet

1. Controleer of DNS naar server wijst
2. Wacht op doorgave
3. Controleer of poorten 80/443 open zijn
4. Herstart Traefik:

   docker restart dokploy-traefik

Onvoldoende Geheugen

1. Controleer met docker stats
2. Voeg swap toe:

   fallocate -l 2G /swapfile
   chmod 600 /swapfile
   mkswap /swapfile
   swapon /swapfile

3. Verminder gelijktijdige apps

Container Start Niet

# Controleer containerlogs
docker logs container-name

# Veelvoorkomende oplossingen:
# - Verkeerde poort blootgesteld
# - Ontbrekende omgevingsvariabelen
# - Gezondheidscontrole mislukt

Prestatie-optimalisatie

Swap Inschakelen

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile swap swap defaults 0 0' >> /etc/fstab

Docker Opruimen

# Verwijder ongebruikte images
docker system prune -a

# Plan wekelijkse opruiming
echo "0 3 * * 0 docker system prune -af" | crontab -

Resourcelimieten

Stel in per app in compose:

services:
  app:
    deploy:
      resources:
        limits:
          memory: 512M
          cpus: '0.5'

API-toegang

Dokploy heeft een REST API:

# Haal auth-token op uit instellingen

# Lijst projecten op
curl -X GET https://dokploy.yourdomain.com/api/projects \
  -H "Authorization: Bearer YOUR_TOKEN"

# Activeer deployment
curl -X POST https://dokploy.yourdomain.com/api/application/deploy \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"applicationId": "xxx"}'

Veelgestelde Vragen

Hoeveel apps kan Dokploy verwerken?

Op een 4GB VPS: 5-15 lichtgewicht apps zonder problemen. Meer met juiste resourcelimieten.

Is Dokploy klaar voor productie?

Ja, het wordt actief onderhouden en gebruikt in productie. v0.8+ is stabiel.

Dokploy vs Coolify?

Beide zijn uitstekend. Dokploy heeft een eenvoudigere UI, Coolify heeft meer functies. Probeer beide.

Kan ik migreren vanuit Heroku?

Ja! Voeg je repo toe, configureer buildpacks of Dockerfile, deploy.

Hoe update ik Dokploy?

curl -sSL https://dokploy.com/install.sh | sh

Hetzelfde commando werkt bij naar de nieuwste versie.

Samenvatting

Dokploy maakt van een VPS van $5 een krachtig deployment platform:

Wat Je Krijgt	Kosten
Onbeperkte apps	Alleen VPS-kosten
Automatisch SSL	Inbegrepen
Git-deployments	Inbegrepen
Databases	Inbegrepen
Aangepaste domeinen	Onbeperkt

Aanbevolen Installatie:

1. Haal Hostinger VPS ($4.99/mo)
2. Installeer Dokploy
3. Verbind GitHub
4. Deploy alles

Dat is $5/maand voor je eigen Vercel. Geen limieten, geen vendor lock-in, volledige controle.