Coolify VPS Installatiehandleiding: Je Eigen Vercel

Coolify is een zelf-gehost PaaS dat je VPS omtovert in een Vercel/Netlify-achtig platform. Implementeer apps vanuit Git, automatische SSL, zero-downtime implementaties — allemaal op hardware die je zelf beheert.

Wat is Coolify?

Coolify regelt de complexiteit van de infrastructuur:

• Git-integratie — Push om te deployen
• Automatische SSL — Let’s Encrypt ingebouwd
• Meerdere talen — Node, Python, PHP, Go, Rust, statische sites
• Databases — PostgreSQL, MySQL, Redis, MongoDB met één klik
• Docker-ondersteuning — Implementeer elk Dockerfile
• Webhooks — Automatische implementaties bij push

Zie het als een zelf-gehoste Heroku/Vercel voor een fractie van de kosten.

Waarom Coolify in plaats van Vercel?

Factor	Vercel	Coolify op VPS
Kosten (3 apps)	$60/mnd+	$5-15/mnd
Resources	Beperkt	Volledige VPS
Vendor lock-in	Hoog	Geen
Koude starts	Ja	Nee
Aangepaste domeinen	Beperkt gratis	Onbeperkt
Database hosting	Extra kosten	Inbegrepen

Break-even punt: Als je meer dan $20/mnd betaalt op Vercel, bespaart Coolify geld.

VPS Vereisten

Coolify heeft nodig:

• Minimum: 2 vCPU, 2GB RAM, 30GB opslag
• Aanbevolen: 4 vCPU, 4GB RAM, 50GB+ opslag
• OS: Ubuntu 22.04+ of Debian 12+
• Poorten: 80, 443, 8000 (dashboard)

Aanbevolen VPS Providers

Provider	Plan	Specificaties	Prijs
Hostinger	KVM1	1 vCPU, 4GB RAM	$4,99/mnd
Hetzner	CX21	2 vCPU, 4GB RAM	€5,39/mnd
Vultr	VC2	2 vCPU, 4GB RAM	$24/mnd

Beste waarde: Hostinger KVM1 — 4GB RAM voor $4,99 verwerkt 5-10 apps moeiteloos.

Installatiehandleiding

Stap 1: Maak Je VPS Aan

Met Hetzner als voorbeeld:

1. Registreer bij Hetzner Cloud
2. Maak Project aan → Server Toevoegen
3. Selecteer: Ubuntu 22.04, CX21 (2 vCPU, 4GB RAM)
4. Voeg je SSH-sleutel toe
5. Maak de server aan, noteer het IP-adres

Stap 2: Koppel Je Domein

Stel DNS in vóór de installatie:

A    coolify.jouwdomein.com    → jouw-server-ip
A    *.coolify.jouwdomein.com  → jouw-server-ip

De wildcard is belangrijk — elke app krijgt een subdomein.

Stap 3: Verbind en Bereid Voor

ssh root@your-server-ip

# Systeem updaten
apt update && apt upgrade -y

# Hostnaam instellen (optioneel maar handig)
hostnamectl set-hostname coolify

# Herstarten om updates toe te passen
reboot

Stap 4: Installeer Coolify

Eén commando installeert alles:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

Dit installeert:

• Docker Engine
• Coolify applicatie
• Traefik reverse proxy
• PostgreSQL voor Coolify gegevens

Installatie duurt 2-5 minuten.

Stap 5: Open het Dashboard

Open in je browser:

http://your-server-ip:8000

Of als DNS gereed is:

http://coolify.yourdomain.com:8000

Maak je beheerdersaccount aan bij het eerste bezoek.

Stap 6: Configureer SSL

In het Coolify dashboard:

1. Ga naar Settings → Configuration
2. Stel je Instance FQDN in op https://coolify.yourdomain.com
3. Schakel Let’s Encrypt in
4. Voer je e-mailadres in voor SSL-meldingen
5. Sla op en wacht op het certificaat

Nu bereikbaar via https://coolify.yourdomain.com

Je Eerste App Implementeren

Optie A: Vanuit Git Repository

1. Sources → Voeg GitHub/GitLab toe
2. Autoriseer OAuth-toegang
3. Projects → Nieuw Project → Nieuwe Resource
4. Selecteer Public Repository of je gekoppelde account
5. Voer de repo-URL in (bijv. https://github.com/you/app)
6. Coolify detecteert automatisch: Node, Python, PHP, statisch, Docker
7. Klik op Deploy

Coolify bouwt en implementeert automatisch. Je krijgt een URL zoals: https://app-xxxx.coolify.yourdomain.com

Optie B: Met Docker Compose

Voor bestaande Docker-projecten:

1. Projects → Nieuwe Resource → Docker Compose
2. Plak of link naar je compose-bestand:

version: '3'
services:
  app:
    image: nginx:alpine
    ports:
      - 80:80

3. Implementeer

Optie C: Implementeer vanuit Dockerfile

1. Maak resource aan → Dockerfile
2. Link naar repo met Dockerfile
3. Coolify bouwt en implementeert

Veelvoorkomende Implementaties

Next.js App

# In Coolify:
# 1. Voeg Git-bron toe
# 2. Selecteer je Next.js repo
# 3. Coolify detecteert automatisch Node, gebruikt build-output

Build-commando: npm run build Start-commando: npm start

Python/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 Site

Verwijs simpelweg naar een repo met index.html — Coolify serveert deze automatisch.

WordPress

1. New Resource → Services → WordPress
2. Eén klik implementeert WordPress + MySQL
3. SSL en domein worden automatisch afgehandeld

Databases Toevoegen

PostgreSQL

1. Resources → Nieuwe Resource → PostgreSQL
2. Stel wachtwoord in
3. Implementeer

Verbindingsstring verschijnt in het dashboard:

postgresql://user:password@postgres-xxxx:5432/postgres

Gebruik in je apps via omgevingsvariabelen.

Redis

Hetzelfde proces:

1. Nieuwe Resource → Redis
2. Implementeer
3. Gebruik redis://redis-xxxx:6379 in je apps

MySQL/MariaDB

1. Nieuwe Resource → MySQL of MariaDB
2. Configureer
3. Implementeer

Automatische Implementaties

GitHub Webhooks

Coolify configureert automatisch webhooks wanneer je GitHub koppelt:

1. Push naar main branch
2. Webhook wordt getriggerd
3. Coolify haalt op, bouwt, implementeert
4. Zero-downtime wissel

Handmatige Triggers

Bij elke app:

• Klik op Redeploy voor handmatige trigger
• Gebruik de API voor CI/CD-integratie:

curl -X POST https://coolify.yourdomain.com/api/v1/deploy \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{"uuid": "app-uuid"}'

Omgevingsvariabelen

Per Applicatie

1. Open de app in het dashboard
2. Tabblad Environment Variables
3. Voeg sleutel-waardeparen toe:

DATABASE_URL=postgresql://...
API_KEY=secret123
NODE_ENV=production

Gedeeld Tussen Apps

1. Projects → Selecteer project
2. Shared Variables
3. Deze worden in alle apps van het project geïnjecteerd

Aangepaste Domeinen

Domein aan App Toevoegen

1. Open app → Settings
2. Domains → Domein toevoegen
3. Voer in: app.jouwdomein.com
4. SSL wordt automatisch ingericht

Meerdere Domeinen

Voeg er zoveel toe als nodig:

app.jouwdomein.com
www.jouwdomein.com
jouwdomein.com

Allemaal verwijzend naar dezelfde app.

Back-up Strategie

Database Back-ups

Coolify ondersteunt geplande back-ups:

1. Open database resource
2. Backups → Inschakelen
3. Stel schema in (dagelijks aanbevolen)
4. Configureer S3/Minio bestemming

Applicatiegegevens

Voor apps met persistente gegevens:

# Op VPS, back-up Docker volumes
docker run --rm -v app_data:/data -v /backup:/backup \
  alpine tar czf /backup/app-backup.tar.gz /data

Volledige VPS Snapshots

Gebruik de snapshotfunctie van je provider:

• Hetzner: €0,012/GB/maand
• Hostinger: Wekelijks inbegrepen
• Vultr: 20% van VPS-kosten

Prestatietips

1. Schakel Swap In

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

2. Ruim Docker Resources Op

# Wekelijkse opschoning
docker system prune -a --volumes -f

Of schakel in via Coolify-instellingen.

3. Monitor Resources

# Controleer container statistieken
docker stats

Het Coolify dashboard toont resourcegebruik per app.

4. Schaal Horizontaal

Voor apps met veel verkeer, voeg meer VPS-instanties toe en gebruik Coolify’s serverbeheer om implementaties te verdelen.

Probleemoplossing

App Wordt Niet Geïmplementeerd

# Controleer logs
docker logs coolify

# Controleer app build logs in dashboard
# Resources → App → Deployments → View logs

SSL Werkt Niet

1. Controleer of DNS correct verwijst
2. Wacht op propagatie (tot 24 uur)
3. Controleer of poort 80/443 open is in de firewall
4. Herstart Traefik: docker restart coolify-proxy

Onvoldoende Schijfruimte

# Controleer gebruik
df -h

# Ruim Docker op
docker system prune -a

# Verwijder oude implementaties in Coolify-instellingen

Database Verbinding Geweigerd

1. Controleer of de database-container draait
2. Gebruik de interne Docker-hostnaam (bijv. postgres-xxxx)
3. Controleer inloggegevens in het Coolify dashboard

Coolify vs Alternatieven

Platform	Complexiteit	Beste Voor
Coolify	Laag	Algemeen PaaS, meerdere apps
Dokploy	Laag	Vergelijkbaar met Coolify
CapRover	Gemiddeld	Docker-gericht
Portainer	Laag	Containerbeheer
Kubernetes	Hoog	Grote schaal

Coolify wint op eenvoud en biedt tegelijkertijd genoeg kracht voor de meeste projecten.

Veelgestelde Vragen

Hoeveel apps kan Coolify draaien?

Op een 4GB VPS: 5-15 lichtgewicht apps. Meer met zorgvuldig resourcebeheer.

Is Coolify productierijp?

Ja, veel bedrijven gebruiken het. De v4 release is stabiel en wordt actief onderhouden.

Kan ik mijn eigen Docker registry gebruiken?

Ja, configureer via Settings → Docker Registries.

Ondersteunt Coolify monorepo’s?

Ja, specificeer de subdirectory die je app bevat.

Hoe update ik Coolify?

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

Hetzelfde installcommando werkt bij naar de nieuwste versie.

Samenvatting

Coolify transformeert een $5-15/mnd VPS in een implementatieplatform dat kan concurreren met Vercel/Netlify. Voor ontwikkelaars en kleine teams is het de perfecte balans tussen doe-het-zelf Docker en dure PaaS.

Aanbevolen Setup:

Component	Keuze	Kosten
VPS	Hostinger KVM1	$4,99/mnd
Platform	Coolify	Gratis
Domeinen	Cloudflare	Gratis
Totaal		$4,99/mnd

Begin hier: Hostinger VPS → Installeer Coolify → Implementeer apps.