Dokploy VPS Setup-Anleitung: Selbst gehostete Deployment-Plattform

Dokploy ist ein Open-Source-PaaS, das das Deployment von Anwendungen kinderleicht macht. Stell es dir als dein persönliches Vercel/Railway vor, das auf jedem VPS läuft.

Was ist Dokploy?

Dokploy übernimmt die langweiligen Teile des Deployments:

• Git-basierte Deployments — Push zum Deployen
• Automatisches SSL — Let’s Encrypt-Integration
• Docker-nativ — Jede containerisierte App ausführen
• Datenbank-Templates — Ein-Klick PostgreSQL, MySQL, Redis
• Traefik-Routing — Automatische Domain-Verwaltung
• Echtzeit-Logs — Deployments live überwachen

Dokploy vs. andere Plattformen

Feature	Dokploy	Coolify	Vercel
Preis	Kostenlos (VPS-Kosten)	Kostenlos (VPS-Kosten)	$20+/Mo.
Self-hosted	✅	✅	❌
Docker Compose	✅	✅	❌
Multi-Server	✅	✅	❌
UI-Einfachheit	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
Features	Wachsend	Ausgereift	Die meisten

Dokploy ist neuer, hat aber eine übersichtlichere Benutzeroberfläche und eine schnellere Einrichtung.

VPS-Anforderungen

Minimum:

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

Empfohlen:

• 2 vCPU, 4 GB RAM
• 50 GB Speicher
• Ubuntu 22.04 oder Debian 12

Beste VPS für Dokploy

Anbieter	Plan	Specs	Preis
Hostinger	KVM1	1 vCPU, 4 GB RAM	$4,99/Mo.
Hetzner	CX21	2 vCPU, 4 GB RAM	€5,39/Mo.
Vultr	VC2	1 vCPU, 2 GB RAM	$12/Mo.

Installation

Schritt 1: VPS erstellen

1. Bei Hetzner oder Hostinger registrieren
2. Ubuntu 22.04 Server erstellen
3. SSH-Schlüssel hinzufügen
4. IP-Adresse notieren

Schritt 2: DNS einrichten

Richte deine Domain vor der Installation ein:

A    dokploy.yourdomain.com      → your-server-ip
A    *.dokploy.yourdomain.com    → your-server-ip

Der Wildcard-Eintrag gibt jeder App eine Subdomain.

Schritt 3: Mit dem Server verbinden

ssh root@your-server-ip

# System aktualisieren
apt update && apt upgrade -y

Schritt 4: Dokploy installieren

Ein Befehl erledigt alles:

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

Dies installiert:

• Docker
• Dokploy-Anwendung
• Traefik Reverse Proxy
• PostgreSQL (für Dokploy-Daten)

Dauert etwa 3–5 Minuten.

Schritt 5: Dashboard aufrufen

http://your-server-ip:3000

Erstelle dein Admin-Konto. Verwende ein sicheres Passwort.

Schritt 6: Domain & SSL konfigurieren

1. Gehe zu Einstellungen
2. Server-Domain festlegen: dokploy.yourdomain.com
3. SSL/TLS aktivieren
4. E-Mail für Let’s Encrypt eingeben
5. Speichern

Jetzt über https://dokploy.yourdomain.com erreichbar

Anwendungen deployen

Von GitHub deployen

1. Projekte → Neues Projekt
2. Anwendung hinzufügen
3. Quelle auswählen: GitHub
4. GitHub-Zugriff autorisieren
5. Repository auswählen
6. Deploy klicken

Dokploy erkennt automatisch:

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

Mit Docker Compose deployen

Für bestehende Compose-Projekte:

1. Anwendung erstellen → Docker Compose
2. Compose-Datei einfügen oder aus Repo auswählen
3. Deployen

Beispiel-Compose:

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

Dockerfile deployen

1. Anwendung erstellen → Dockerfile
2. Auf Repo mit Dockerfile verweisen
3. Dokploy baut und deployt

Datenbank einrichten

PostgreSQL

1. Projekte → Projekt auswählen
2. Service hinzufügen → PostgreSQL
3. Datenbankname und Passwort festlegen
4. Deployen

Connection String wird im Dashboard angezeigt:

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

MySQL

Gleicher Vorgang:

1. Service hinzufügen → MySQL
2. Zugangsdaten konfigurieren
3. Deployen

Redis

1. Service hinzufügen → Redis
2. Deployen
3. redis://redis-xxx:6379 verwenden

Eigene Domains

Domain zu App hinzufügen

1. Anwendung auswählen
2. Tab Domains
3. Hinzufügen: app.yourdomain.com
4. SSL wird automatisch bereitgestellt

www auf non-www umleiten

Beide Domains hinzufügen, Dokploy übernimmt die Weiterleitungen:

yourdomain.com
www.yourdomain.com

Umgebungsvariablen

Anwendungsvariablen

1. App auswählen → Environment
2. Variablen hinzufügen:

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

Secrets (Verschlüsselt)

Für sensible Daten:

1. Einstellungen → Secrets
2. Secret erstellen
3. In Apps referenzieren: {{SECRET_NAME}}

Deployments & Rollbacks

Automatische Deployments

Webhooks aktivieren:

1. App-Einstellungen → Build
2. Auto Deploy aktivieren
3. Push zu main löst Neubau aus

Manuelles Deployment

Jederzeit auf Deploy klicken.

Rollback

1. Tab Deployments
2. Vorheriges Deployment finden
3. Rollback klicken

Überwachung

Echtzeit-Logs

1. Anwendung auswählen
2. Tab Logs
3. Logs in Echtzeit streamen

Ressourcenauslastung

Das Dashboard zeigt:

• CPU-Auslastung pro App
• Speicherverbrauch
• Festplattenauslastung
• Netzwerktraffic

Health Checks

In den App-Einstellungen konfigurieren:

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

Backups

Datenbank-Backups

1. Datenbank auswählen
2. Backups → Aktivieren
3. Zeitplan festlegen
4. Ziel konfigurieren (S3, lokal)

Manuelles Backup

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

Volume-Backups

Für Apps mit persistenten Daten:

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

Multi-Server-Setup

Dokploy unterstützt mehrere Server:

1. Server → Server hinzufügen
2. Dokploy-Agent auf neuem VPS installieren:

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

3. Server-Token zu Dokploy hinzufügen
4. Apps auf bestimmte Server deployen

Anwendungsfälle:

• Getrennte Staging-/Produktionsumgebungen
• Geografische Verteilung
• Ressourcentrennung

Häufige Deployments

Next.js

1. App erstellen → GitHub → Repo auswählen
2. Build-Befehl: npm run build
3. Start-Befehl: npm start
4. Port: 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 Websites

1. App erstellen → GitHub
2. Build: npm run build
3. Verzeichnis veröffentlichen: dist oder build
4. Dokploy liefert statische Dateien aus

WordPress

1. Service hinzufügen → WordPress
2. Ein-Klick-Setup inklusive MySQL
3. Domain konfigurieren
4. Fertig

Fehlerbehebung

Deployment schlägt fehl

Logs prüfen:

1. App → Deployments → Fehlgeschlagenes Deployment
2. Build-Logs anzeigen
3. Häufige Probleme:
   • Fehlende Abhängigkeiten
   • Port-Konflikt
   • Falscher Build-Befehl

SSL funktioniert nicht

1. DNS-Auflösung auf Server prüfen
2. Auf Propagierung warten
3. Ports 80/443 prüfen, ob offen
4. Traefik neu starten:

   docker restart dokploy-traefik

Speicher zu knapp

1. Mit docker stats prüfen
2. Swap hinzufügen:

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

3. Gleichzeitige Apps reduzieren

Container startet nicht

# Container-Logs prüfen
docker logs container-name

# Häufige Lösungen:
# - Falscher Port angegeben
# - Fehlende Umgebungsvariablen
# - Healthcheck schlägt fehl

Leistungsoptimierung

Swap aktivieren

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

Docker-Bereinigung

# Ungenutzte Images entfernen
docker system prune -a

# Wöchentliche Bereinigung planen
echo "0 3 * * 0 docker system prune -af" | crontab -

Ressourcenlimits

Pro App in Compose festlegen:

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

API-Zugriff

Dokploy verfügt über eine REST API:

# Auth-Token aus den Einstellungen holen

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

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

FAQ

Wie viele Apps kann Dokploy verwalten?

Auf einem 4-GB-VPS: 5–15 leichtgewichtige Apps problemlos. Mehr mit geeigneten Ressourcenlimits.

Ist Dokploy produktionsreif?

Ja, es wird aktiv gepflegt und in der Produktion eingesetzt. v0.8+ ist stabil.

Dokploy vs. Coolify?

Beide sind ausgezeichnet. Dokploy hat eine einfachere Benutzeroberfläche, Coolify hat mehr Features. Probier beide aus.

Kann ich von Heroku migrieren?

Ja! Repo hinzufügen, Buildpacks oder Dockerfile konfigurieren, deployen.

Wie aktualisiere ich Dokploy?

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

Derselbe Befehl aktualisiert auf die neueste Version.

Zusammenfassung

Dokploy verwandelt einen $5-VPS in eine leistungsstarke Deployment-Plattform:

Was du bekommst	Kosten
Unbegrenzte Apps	Nur VPS-Kosten
Automatisches SSL	Inklusive
Git-Deployments	Inklusive
Datenbanken	Inklusive
Eigene Domains	Unbegrenzt

Empfohlenes Setup:

1. Hostinger VPS holen ($4,99/Mo.)
2. Dokploy installieren
3. GitHub verbinden
4. Alles deployen

Das sind $5/Monat für dein eigenes Vercel. Keine Limits, kein Vendor Lock-in, volle Kontrolle.