Coolify VPS Einrichtungsanleitung: Ihr eigenes Vercel

Coolify ist eine selbstgehostete PaaS, die Ihren VPS in eine Vercel/Netlify-aehnliche Plattform verwandelt. Deployen Sie Apps aus Git, automatisches SSL, Zero-Downtime-Deployments — alles auf Hardware, die Sie kontrollieren.

Was ist Coolify?

Coolify uebernimmt die Infrastruktur-Komplexitaet:

• Git-Integration — Push to Deploy
• Automatisches SSL — Let’s Encrypt integriert
• Mehrere Sprachen — Node, Python, PHP, Go, Rust, statische Seiten
• Datenbanken — Ein-Klick PostgreSQL, MySQL, Redis, MongoDB
• Docker-Unterstuetzung — Jedes Dockerfile deployen
• Webhooks — Automatische Deployments bei Push

Betrachten Sie es als selbstgehostetes Heroku/Vercel zu einem Bruchteil der Kosten.

Warum Coolify statt Vercel?

Faktor	Vercel	Coolify auf VPS
Kosten (3 Apps)	$60/Mo+	$5-15/Mo
Ressourcen	Begrenzt	Voller VPS
Anbieter-Abhaengigkeit	Hoch	Keine
Kaltstarts	Ja	Nein
Eigene Domains	Begrenzt kostenlos	Unbegrenzt
Datenbank-Hosting	Zusaetzliche Kosten	Inklusive

Break-even-Punkt: Wenn Sie >$20/Mo bei Vercel zahlen, spart Coolify Geld.

VPS-Anforderungen

Coolify benoetigt:

• Minimum: 2 vCPU, 2GB RAM, 30GB Speicher
• Empfohlen: 4 vCPU, 4GB RAM, 50GB+ Speicher
• Betriebssystem: Ubuntu 22.04+ oder Debian 12+
• Ports: 80, 443, 8000 (Dashboard)

Empfohlene VPS-Anbieter

Anbieter	Tarif	Spezifikationen	Preis
Hostinger	KVM1	1 vCPU, 4GB RAM	$4.99/Mo
Hetzner	CX21	2 vCPU, 4GB RAM	€5.39/Mo
Vultr	VC2	2 vCPU, 4GB RAM	$24/Mo

Bestes Preis-Leistungs-Verhaeltnis: Hostinger KVM1 — 4GB RAM fuer $4.99 bewae ltigt problemlos 5-10 Apps.

Installationsanleitung

Schritt 1: VPS erstellen

Am Beispiel von Hetzner:

1. Registrieren Sie sich bei Hetzner Cloud
2. Projekt erstellen → Server hinzufuegen
3. Auswaehlen: Ubuntu 22.04, CX21 (2 vCPU, 4GB RAM)
4. SSH-Schluessel hinzufuegen
5. Server erstellen, IP-Adresse notieren

Schritt 2: Domain einrichten

Richten Sie vor der Installation das DNS ein:

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

Der Wildcard-Eintrag ist wichtig — jede App erhaelt eine Subdomain.

Schritt 3: Verbinden und vorbereiten

ssh root@your-server-ip

# System aktualisieren
apt update && apt upgrade -y

# Hostname setzen (optional, aber empfehlenswert)
hostnamectl set-hostname coolify

# Neustart um Updates anzuwenden
reboot

Schritt 4: Coolify installieren

Ein Befehl installiert alles:

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

Dies installiert:

• Docker Engine
• Coolify-Anwendung
• Traefik Reverse Proxy
• PostgreSQL fuer Coolify-Daten

Die Installation dauert 2-5 Minuten.

Schritt 5: Dashboard aufrufen

Im Browser oeffnen:

http://your-server-ip:8000

Oder wenn DNS bereits eingerichtet ist:

http://coolify.yourdomain.com:8000

Erstellen Sie beim ersten Besuch Ihr Admin-Konto.

Schritt 6: SSL konfigurieren

Im Coolify-Dashboard:

1. Gehen Sie zu Settings → Configuration
2. Setzen Sie Ihre Instance FQDN auf https://coolify.yourdomain.com
3. Aktivieren Sie Let’s Encrypt
4. Geben Sie Ihre E-Mail fuer SSL-Benachrichtigungen ein
5. Speichern und auf das Zertifikat warten

Jetzt zugreifbar ueber https://coolify.yourdomain.com

Ihre erste App deployen

Option A: Aus Git-Repository

1. Sources → GitHub/GitLab hinzufuegen
2. OAuth-Zugriff autorisieren
3. Projects → Neues Projekt → Neue Ressource
4. Public Repository oder Ihr verbundenes Konto auswaehlen
5. Repository-URL eingeben (z.B. https://github.com/you/app)
6. Coolify erkennt automatisch: Node, Python, PHP, statisch, Docker
7. Auf Deploy klicken

Coolify baut und deployed automatisch. Sie erhalten eine URL wie: https://app-xxxx.coolify.yourdomain.com

Option B: Mit Docker Compose

Fuer bestehende Docker-Projekte:

1. Projects → Neue Ressource → Docker Compose
2. Compose-Datei einfuegen oder verlinken:

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

3. Deployen

Option C: Aus Dockerfile deployen

1. Ressource erstellen → Dockerfile
2. Repository mit Dockerfile verlinken
3. Coolify baut und deployed

Haeufige Deployments

Next.js App

# In Coolify:
# 1. Git-Quelle hinzufuegen
# 2. Ihr Next.js-Repository auswaehlen
# 3. Coolify erkennt automatisch Node, verwendet Build-Output

Build-Befehl: npm run build Start-Befehl: 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 Seite

Verweisen Sie einfach auf ein Repository mit index.html — Coolify stellt es automatisch bereit.

WordPress

1. Neue Ressource → Services → WordPress
2. Ein Klick deployed WordPress + MySQL
3. SSL und Domain werden automatisch eingerichtet

Datenbanken hinzufuegen

PostgreSQL

1. Resources → Neue Ressource → PostgreSQL
2. Passwort festlegen
3. Deployen

Der Verbindungsstring erscheint im Dashboard:

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

Verwenden Sie ihn in Ihren Apps ueber Umgebungsvariablen.

Redis

Gleicher Ablauf:

1. Neue Ressource → Redis
2. Deployen
3. redis://redis-xxxx:6379 in Ihren Apps verwenden

MySQL/MariaDB

1. Neue Ressource → MySQL oder MariaDB
2. Konfigurieren
3. Deployen

Automatische Deployments

GitHub Webhooks

Coolify konfiguriert automatisch Webhooks, wenn Sie GitHub verbinden:

1. Push auf den main-Branch
2. Webhook wird ausgeloest
3. Coolify pullt, baut, deployed
4. Zero-Downtime-Austausch

Manuelle Ausloeser

In jeder App:

• Klicken Sie auf Redeploy fuer manuelles Ausloesen
• Verwenden Sie die API fuer CI/CD-Integration:

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

Umgebungsvariablen

Pro Anwendung

1. App im Dashboard oeffnen
2. Tab Environment Variables
3. Schluessel-Wert-Paare hinzufuegen:

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

App-uebergreifend geteilt

1. Projects → Projekt auswaehlen
2. Shared Variables
3. Diese werden in alle Apps des Projekts injiziert

Eigene Domains

Domain zur App hinzufuegen

1. App oeffnen → Settings
2. Domains → Domain hinzufuegen
3. Eingeben: app.yourdomain.com
4. SSL wird automatisch bereitgestellt

Mehrere Domains

Fuegen Sie so viele hinzu wie noetig:

app.yourdomain.com
www.yourdomain.com
yourdomain.com

Alle verweisen auf dieselbe App.

Backup-Strategie

Datenbank-Backups

Coolify unterstuetzt geplante Backups:

1. Datenbank-Ressource oeffnen
2. Backups → Aktivieren
3. Zeitplan festlegen (taeglich empfohlen)
4. S3/Minio-Ziel konfigurieren

Anwendungsdaten

Fuer Apps mit persistenten Daten:

# Auf dem VPS Docker-Volumes sichern
docker run --rm -v app_data:/data -v /backup:/backup \
  alpine tar czf /backup/app-backup.tar.gz /data

Vollstaendige VPS-Snapshots

Nutzen Sie die Snapshot-Funktion Ihres Anbieters:

• Hetzner: €0.012/GB/Monat
• Hostinger: Woechentlich inklusive
• Vultr: 20% der VPS-Kosten

Leistungstipps

1. Swap aktivieren

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

2. Docker-Ressourcen bereinigen

# Woechentliche Bereinigung
docker system prune -a --volumes -f

Oder in den Coolify-Einstellungen aktivieren.

3. Ressourcen ueberwachen

# Container-Statistiken pruefen
docker stats

Das Coolify-Dashboard zeigt die Ressourcennutzung pro App.

4. Horizontal skalieren

Fuer stark frequentierte Apps fuegen Sie weitere VPS-Instanzen hinzu und nutzen Coolifys Serververwaltung, um Deployments zu verteilen.

Fehlerbehebung

App wird nicht deployed

# Logs pruefen
docker logs coolify

# App-Build-Logs im Dashboard pruefen
# Resources → App → Deployments → Logs anzeigen

SSL funktioniert nicht

1. Ueberpruefen Sie, ob das DNS korrekt zeigt
2. Warten Sie auf die Propagierung (bis zu 24 Stunden)
3. Pruefen Sie, ob Port 80/443 in der Firewall geoeffnet ist
4. Traefik neustarten: docker restart coolify-proxy

Kein Speicherplatz mehr

# Nutzung pruefen
df -h

# Docker bereinigen
docker system prune -a

# Alte Deployments in den Coolify-Einstellungen entfernen

Datenbankverbindung abgelehnt

1. Stellen Sie sicher, dass der Datenbank-Container laeuft
2. Verwenden Sie den internen Docker-Hostnamen (z.B. postgres-xxxx)
3. Pruefen Sie die Anmeldedaten im Coolify-Dashboard

Coolify vs Alternativen

Plattform	Komplexitaet	Am besten fuer
Coolify	Niedrig	Allgemeine PaaS, Multi-App
Dokploy	Niedrig	Aehnlich wie Coolify
CapRover	Mittel	Docker-zentriert
Portainer	Niedrig	Container-Verwaltung
Kubernetes	Hoch	Grosser Massstab

Coolify gewinnt bei der Einfachheit und bietet gleichzeitig genug Leistung fuer die meisten Projekte.

FAQ

Wie viele Apps kann Coolify ausfuehren?

Auf einem 4GB VPS: 5-15 leichtgewichtige Apps. Mehr mit sorgfaeltigem Ressourcenmanagement.

Ist Coolify produktionsreif?

Ja, viele Unternehmen nutzen es. Die v4-Version ist stabil und wird aktiv weiterentwickelt.

Kann ich meine eigene Docker-Registry verwenden?

Ja, konfigurierbar unter Settings → Docker Registries.

Unterstuetzt Coolify Monorepos?

Ja, geben Sie das Unterverzeichnis an, das Ihre App enthaelt.

Wie aktualisiere ich Coolify?

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

Derselbe Installationsbefehl aktualisiert auf die neueste Version.

Zusammenfassung

Coolify verwandelt einen $5-15/Mo VPS in eine Deployment-Plattform, die mit Vercel/Netlify konkurrieren kann. Fuer Entwickler und kleine Teams ist es der ideale Mittelweg zwischen DIY-Docker und teuren PaaS-Loesungen.

Empfohlenes Setup:

Komponente	Auswahl	Kosten
VPS	Hostinger KVM1	$4.99/Mo
Plattform	Coolify	Kostenlos
Domains	Cloudflare	Kostenlos
Gesamt		$4.99/Mo

Starten Sie hier: Hostinger VPS → Coolify installieren → Apps deployen.