Coolify (Self-hosted PaaS)

1. Überblick über das Konzept und das Systemproblem

Cloud-PaaS-Plattformen (Vercel, Heroku, Netlify, Render) boten Entwicklern ein beispielloses Maß an Komfort: Ein einfacher git push baut das Projekt automatisch auf, weist eine Domain zu, richtet SSL ein und stellt den Service bereit. Doch für diesen Komfort zahlen Unternehmen mit finanzieller Abhängigkeit und strengen architektonischen Einschränkungen:

• Raubtier-Billing: Die Traffic-Kosten in der Cloud sind um das 10–20-fache höher als der Marktdurchschnitt, und Rechnungen für die Überschreitung von Limits können sich auf Tausende von Dollar belaufen.
• Serverless-Timeouts: Das Limit für die Funktionsausführung (15–60 Sekunden) macht die Ausführung autonomer Agent-Zyklen, komplexes Scraping oder langwierige Überlegungen von Sprachmodellen unmöglich.
• Vendor-Lock-in: Spezifische Optimierungen erschweren die Migration des Codes auf eigene Hardware.

Coolify bietet das Beste aus beiden Welten: Eine Vercel-Erfahrung auf einem eigenen Server für $5–$20 pro Monat. Es handelt sich um ein Open-Source-Self-Hosted PaaS, das mit einem einzigen Befehl installiert wird, sich mit GitHub/GitLab-Repositories verbindet und den gesamten Zyklus von Build, Traffic-Routing und Datenbankverwaltung übernimmt.

2. Architektonische Taxonomie und mentales Modell

Das architektonische Fundament von Coolify basiert auf der Orchestrierung des Docker-Daemons und einem dynamischen Proxy:

┌─────────────────────────────────────────────────────────────┐
│                    COOLIFY HOST ARCHITECTURE                │
├─────────────────────────────────────────────────────────────┤
│ 1. Dynamic Reverse Proxy (Traefik v3 Core Engine)           │
│    • Автоматичний роутинг портів через Docker Labels        │
│    • Автоматичні SSL-сертифікати Let's Encrypt (ACME)       │
├─────────────────────────────────────────────────────────────┤
│ 2. Coolify Control Plane (Laravel API & Live Web UI)        │
│    • Менеджер вебхуків GitHub / GitLab                      │
│    • Управління змінними середовища (.env encryption)       │
├─────────────────────────────────────────────────────────────┤
│ 3. Polyglot Build Engine:                                   │
│    • Nixpacks (Автодетекція мов: Node, Bun, Python, Go)     │
│    • Dockerfile / Docker Compose Builder                    │
├─────────────────────────────────────────────────────────────┤
│ 4. Managed Datastores & Storage (Postgres, Redis, S3 Backup)│
└─────────────────────────────────────────────────────────────┘

1. Dynamischer Reverse Proxy (Traefik Engine):
   • Der zentrale Dispatcher für eingehenden Traffic. Er lauscht kontinuierlich auf dem Docker-Socket: Wenn ein neuer Container mit Domain-Labels hochfährt, erkennt Traefik ihn sofort, stellt ein SSL-Zertifikat aus und leitet HTTP/HTTPS-Anfragen ohne Neustart des Proxys weiter.
2. Universelle Build-Engine (Nixpacks & Docker):
   • Ermöglicht den Code-Build, ohne dass komplexe Dockerfiles manuell geschrieben werden müssen. Nixpacks erkennt automatisch die Node.js-Version, installiert Abhängigkeiten über pnpm und generiert einen minimalen Container.
3. One-Click-Datenbankverwaltung (Managed Databases):
   • Bereitstellung produktiver Instanzen von PostgreSQL, Redis, MySQL, ClickHouse oder MinIO mit automatisierten, verschlüsselten Backups in S3-Cloud-Speicher (AWS oder Cloudflare R2) nach Zeitplan.
4. Umgebungsisolierung (Preview Deployments):
   • Automatisches Hochfahren separater, ephemeraler Kopien des Services für jeden offenen Pull Request auf temporären Subdomains.

3. Technischer Pipeline und interne Mechanik

Der Lebenszyklus des Continuous Deployment (GitOps Lifecycle) in Coolify:

1. Code-Fixierung und Webhook: Der Entwickler führt git push origin main aus. GitHub sendet einen signierten HMAC-Webhook an die Coolify-API.
2. Validierung und Worker-Start: Coolify überprüft die Sicherheits-Signatur, holt den aktuellen Commit anhand des angegebenen SHA-Hashes ab und startet einen isolierten Build-Container.
3. Kompilierungsphase (Nixpacks Build): Abhängigkeiten werden installiert, der App-Build ausgeführt (npm run build). Ein optimiertes Produktions-Docker-Image wird erstellt.
4. Nahtloser Traffic-Switch (Rolling Deployment):
   • Ein neuer Container mit der Anwendung wird auf einem neuen internen Port hochgefahren.
   • Traefik prüft den Health Check.
   • Sobald der neue Container HTTP 200 zurückgibt, schaltet der Proxy den Traffic um, und der alte Container wird gestoppt (Zero-Downtime Swap).
5. Alerting und Benachrichtigungen: Der Status des erfolgreichen Deployments wird dem Ingenieur per Telegram oder Discord mit Link zum Commit übermittelt.

4. Praktische Engineering-Szenarien im Production-Umfeld

01. Deployment einer Next.js 15 Full-Stack-Plattform auf einem $10-Server

Ein vollständiger Start eines kommerziellen SaaS auf einem Hetzner-VPS:

• Coolify baut das Next.js-Frontend, stellt die PostgreSQL-Datenbank sowie Redis für Session-Caching bereit.
• Der Traffic läuft über den integrierten Traefik mit Unterstützung für HTTP/2 und SSL.
• Der Service hält eine Million Aufrufe pro Monat stand, ohne zusätzliche Cloud-Kosten.

02. Hosting langlaufender AI-Agents ohne Timeouts

Bereitstellung komplexer Backend-Prozesse (LangGraph, Auto-Scraping):

• Auf Vercel bricht die Anfrage nach 60 Sekunden ab.
• In Coolify kann der Agent autonom 4 Stunden ununterbrochen in einem Hintergrund-Container laufen und offene WebSocket-Verbindungen zum Client aufrechterhalten.

03. Erstellung temporärer Preview-Umgebungen (PR Previews)

Organisation komfortabler Reviews für das Team:

• Beim Öffnen von PR #87 fährt Coolify die Anwendung automatisch unter der Adresse pr-87.gotburnout.dev hoch.
• Tester prüfen die Funktionalität live vor dem Merge in den Main-Branch; danach wird der Container beim Schließen des PR automatisch entfernt.

5. Fallstricke, typische Fehler und Sicherheit

• Serverabsturz durch Speicherüberlauf (Build OOM): Der Build moderner Frontend-Projekte auf Basis von Next.js kann während der Bundle-Optimierung bis zu 3–4 GB RAM verbrauchen. Auf Servern mit 2 GB RAM muss zwingend eine Swap-Datei (swapfile) mit mindestens 4 GB Größe angelegt werden.
• Offene Admin-Oberfläche für Scanner: Standardmäßig läuft die Coolify-Oberfläche auf Port 8000. Sichern Sie diese unbedingt mit einer eigenen Domain und erzwungener Zwei-Faktor-Authentifizierung (2FA) oder blockieren Sie sie über die UFW-Firewall, sodass Traffic nur über Tailscale/VPN zugelassen wird.
• Plattenplatzfüllung durch alte Docker-Images: Tägliches Deployment erzeugt dutzende kompilierte Layer. Wenn die automatische Bereinigung (Docker Cleanup Scheduler) nicht aktiviert ist, füllt sich die Disk innerhalb weniger Wochen.
• Speicherung von Datenbank-Passwörtern in unsicheren Dateien: Nutzen Sie den integrierten Secret Manager von Coolify zur Injection von Umgebungsvariablen, statt .env-Dateien ins Repository zu committen.