Coolify installieren: Du setzt Coolify auf einem Linux-Server auf, startest deine erste Docker-Anwendung und verbindest sie mit app.example.com über HTTPS. Dazu richten wir DNS und optional *.apps.example.com ein.
Das Ergebnis: Eine erreichbare Testanwendung, ein funktionsfähiger Reverse Proxy, eine eigene HTTPS-Domain und ein klarer Weg vom Git-Repository zum Deployment.
Stand: 3. November 2026. Das Tutorial orientiert sich an den offiziellen Coolify-Anleitungen zur selbst gehosteten Installation, zur ersten App und zum DNS-Routing. Es behandelt eine neue Ubuntu-Linux-VM oder einen neuen Server. Läuft Coolify bereits als TrueNAS-SCALE-App, dann verwende für Updates den TrueNAS-App-Mechanismus statt den folgenden externen Installationsbefehl auf dem TrueNAS-Host.
Was ist Coolify? Projekte, Ressourcen und Umgebungen erklärt
Coolify ist eine selbst gehostete Plattform, mit der du Container-Anwendungen, Websites, Docker-Compose-Stacks und Datenbanken über eine Weboberfläche bereitstellst. Projekt bedeutet die organisatorische Sammlung, Environment etwa „production“ oder „staging“, und eine Ressource ist die konkrete Anwendung, Datenbank oder der Service. Coolify erstellt Docker-Container und steuert für Webanwendungen normalerweise den integrierten Reverse Proxy (standardmäßig Traefik).
Bildquelle: Coolify-Dokumentation (offizieller Screenshot) – Dashboard. Abbildung kann je nach Version abweichen.
1. Voraussetzungen und bestehende Ports prüfen
- Für eine reguläre Installation: frischer Linux-Server mit Root-/sudo-Zugriff, vorzugsweise Ubuntu LTS und genügend CPU, RAM und freiem Speicher für Docker und deine Apps.
- Eine eigene Domain ist für den allerersten Test optional, für produktiven HTTPS-Betrieb jedoch empfehlenswert.
- SSH-Zugriff und offene benötigte Ports:
8000für die Ersteinrichtung, ggf.6001/6002für direkte Live-Funktionen, sowie80/443für den Reverse Proxy. - Vorhandene Dienste, insbesondere Apache, Nginx, Pangolin oder bereits ein anderer Traefik, dürfen die benötigten Host-Ports nicht blockieren.
sudo ss -lntup | grep -E ":(80|443|8000|6001|6002)\b" || true
sudo docker ps --format "table {{.Names}}\t{{.Ports}}"Produktiv-Tipp: Führe einen offiziellen Installer nie ungetestet auf einem Host mit bestehenden Containern aus. Lege eine neue VM an oder verwende eine separate Maschine. Auf TrueNAS SCALE greifen App-Management, Netzwerke und Mounts ineinander; eine parallele manuelle Coolify-Installation auf dem TrueNAS-Basissystem ist nicht mit einer Installation in einer Linux-VM gleichzusetzen.
2. Coolify mit offiziellem Installationsskript installieren
Melde dich an deinem Linux-Zielserver an. Kontrolliere die offizielle Installationsadresse, prüfe das Skript bei Bedarf zuerst separat und starte dann die vom Coolify-Projekt dokumentierte Installation:
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bashErfolgskontrolle: Am Ende der Installation nennt Coolify die Verwaltungsadresse; bei der Standardkonfiguration öffnest du http://SERVER-IP:8000. Lege sofort das erste Administratorkonto an – wer die ungeschützte Registrierungsseite zuerst erreicht, könnte sonst Administrator werden. Sichere anschließend die Datei /data/coolify/source/.env außerhalb des Servers, da sie Wiederherstellungsgeheimnisse enthält. Bei bestehender Coolify-Installation den Installer nicht als reguläres Updateverfahren verwenden.
Die Installation richtet die benötigten Komponenten ein. Danach erreichst du das Dashboard zunächst normalerweise unter http://SERVER-IP:8000. Erstelle sofort dein Administrator-Konto, bevor eine fremde Person die ungeschützte Erstregistrierung aufrufen könnte. Beschränke den direkten Zugang anfangs auf dein vertrauenswürdiges Netz, einen VPN-Zugang oder eine Provider-Firewall.
Für eine spätere Wiederherstellung ist insbesondere /data/coolify/source/.env relevant: Sie enthält Schlüssel zur Verschlüsselung von Coolify-Daten. Sichere die Datei geschützt und veröffentliche ihren Inhalt nicht.
3. Dashboard, Server und Proxy überprüfen
- Melde dich in Coolify an und öffne Servers.
- Prüfe, ob der lokale Server beziehungsweise der gewünschte Deployment-Server hinzugefügt und validiert wurde.
- Öffne den Serverbereich Proxy: Für die hier beschriebene eigene Domain muss der integrierte Traefik- oder Caddy-Proxy laufen.
- Wenn ein anderer Reverse Proxy die öffentliche Schnittstelle besitzt, plane bewusst eine alternative Route; starte nicht blind den Coolify-Proxy mit denselben Host-Ports.
4. Dein erstes Projekt und deine erste Anwendung starten
Die zuverlässigste Funktionsprobe aus der Coolify-Dokumentation nutzt ein fertiges Nginx-Image – ohne Git, Buildpack oder Datenbank.
- Klicke auf New Project, wähle zum Beispiel „Homelab“ und öffne die Umgebung „production“.
- Wähle Create New Resource und anschließend Docker Image.
- Gib als Image
nginx:alpineein und setze Ports Exposes auf80. - Lasse für den ersten Funktionstest die generierte
sslip.io-Testadresse bestehen. Diese ist nur eine vorübergehende HTTP-Adresse. - Klicke Deploy. Der gestartete Container soll über die erzeugte URL die Nginx-Willkommensseite anzeigen.
Bildquelle: Coolify-Dokumentation (offizieller Screenshot) – Ressourcentyp auswählen. Abbildung kann je nach Version abweichen.
Das ist ein guter End-to-End-Test für Docker, Proxy-Routing und die Anwendung. Beachte: Ports Exposes 80 beschreibt den Port im Container – nicht einen weiteren öffentlich freizugebenden Host-Port. Besucher nutzen nach der Domain-Einrichtung in der Regel HTTPS auf Port 443.
5. Eine eigene Domain für eine Coolify-App einrichten
Angenommen deine Test-App soll später unter app.example.com erreichbar sein und der Deployment-Server hat die öffentliche IP 203.0.113.20. Lege beim DNS-Anbieter zunächst einen A-Eintrag für den Hostnamen an:
Typ: A
Name: app
Wert: 203.0.113.20
TTL: AutoPrüfe die öffentliche Auflösung und konfiguriere die Domain in der konkreten Coolify-Ressource: Domains → Add domain, Protokoll https, Hostname app.example.com, gegebenenfalls interner Zielport 80, speichern und anschließend die Ressource redeployen. Coolify erstellt die Proxy-Route; bei erreichbarem Dienst und passender Zertifikatskonfiguration beschafft Traefik/Caddy ein TLS-Zertifikat.
dig @1.1.1.1 app.example.com A +short
curl -I https://app.example.comDie DNS-IP gehört immer zum Server, auf dem die Zielressource tatsächlich läuft, nicht automatisch zum Server mit dem Coolify-Dashboard. Befinden sich Dashboard und Anwendung auf getrennten Servern, beachte diese Unterscheidung. Wird Cloudflare mit orangefarbener Wolke aktiviert, können öffentliche DNS-Abfragen Cloudflare-Adressen zurückgeben; das allein ist kein Fehlersignal.
6. Wildcard-Domain *.example.com für viele Apps aktivieren
Für ein Homelab mit vielen Anwendungen musst du nicht für jeden Hostnamen einen neuen A-Eintrag erstellen. Ein Wildcard-DNS-Eintrag leitet passende Subdomains zum selben Ziel:
Typ: A
Name: *
Wert: 203.0.113.20
TTL: AutoIn Coolify → Servers → dein Server → General → Wildcard Domain trägst du die Basis-Domain im von Coolify erwarteten Format ein, beispielsweise https://example.com. Anschließend kann Coolify beim Anlegen neuer Ressourcen automatisch Hostnamen wie abc123.example.com generieren. Das ändert keine bestehenden Domains und erzeugt keine DNS-Einträge von selbst.
Wichtig: Ein Wildcard-DNS-Eintrag garantiert noch kein Wildcard-Zertifikat. Neue Einzel-Hostnamen können mit Einzelzertifikaten funktionieren; ein gemeinsames *.example.com-TLS-Zertifikat benötigt bei Let’s Encrypt die DNS-01-Challenge. Coolify dokumentiert hierfür gesondert die Traefik-DNS-Challenge und Wildcard-Zertifikate. Ein solches Zertifikat schützt standardmäßig nur die passende Subdomain-Ebene.
7. Cloudflare, HTTPS und Redirect-Loops vermeiden
Du kannst Cloudflare als autoritativen DNS-Dienst nutzen. Entscheide dich für DNS only (direkter Serverzugriff) oder Proxied (Cloudflare als vorgeschalteter HTTP-Proxy). Bei Proxied muss der Server aus Cloudflare-Sicht erreichbar sein und die TLS-Einstellungen müssen zusammenpassen. Für sichere HTTPS-Verbindungen zum Origin ist Full (strict) mit gültigem Origin-Zertifikat sinnvoll; „Flexible“ zusammen mit HTTPS-Weiterleitungen verursacht oft Endlosschleifen.
Ein bestehender Cloudflare Tunnel ist wiederum eine alternative Eingangsroute: Der öffentliche Hostname zeigt dann typischerweise als CNAME auf <TUNNEL-ID>.cfargotunnel.com, und die Route des Tunnels muss zum richtigen lokalen Reverse Proxy oder Dienst führen. Du darfst nicht gleichzeitig annehmen, dass derselbe Hostname direkt auf den Coolify-Server und über einen Tunnel auf einen anderen Host zeigt.
8. GitHub-Repository statt Docker-Image deployen
Wenn die Test-App funktioniert, kannst du eigene Projekte automatisch aus Git bereitstellen. Öffne im Projekt Create New Resource und wähle einen passenden Git-Typ: öffentliches Repository über HTTPS oder eine authentifizierte GitHub-Quelle für private Repositories. Bei privaten Projekten verbindest du die Quelle in Coolify über den vorgesehenen Git-Provider-/GitHub-App-Flow statt ein GitHub-Passwort in ein öffentliches Repository zu schreiben.
Bildquelle: Coolify-Dokumentation (offizieller Screenshot) – Git-Anbindung. Abbildung kann je nach Version abweichen.
- Git-URL beziehungsweise verbundenes Repository und den Branch auswählen.
- Den passenden Build Pack wählen: beispielsweise Dockerfile, Docker Compose oder das vom Projekt unterstützte automatische Build-Verfahren.
- Wenn das Repository nicht im Root-Verzeichnis gebaut wird, das korrekte Base Directory eintragen.
- Den tatsächlichen internen Anwendungsport eintragen und notwendige Umgebungsvariablen als Secrets konfigurieren.
- Ersten Build durchführen, Logs auf Fehler prüfen und die richtige Domain hinzufügen. Erst danach automatisierte Deployments oder Webhooks aktivieren.
„No Dockerfile or Compose file found“ ist nicht automatisch ein Fehler: Für unterstützte Anwendungen kann ein automatisches Buildpack verwendet werden. Wenn das Projekt eine eigene Dockerfile benötigt, muss diese im gewählten Verzeichnis vorhanden sein. Nicht jedes Repository ist ohne Konfiguration direkt als Webanwendung deploybar.
9. Coolify mit Pangolin kombinieren – ohne Portkonflikte
Die sauberste Architektur für viele private Setups ist: Pangolin auf einem getrennten Gateway und Coolify auf einem internen Server oder in einer VM. Eine Pangolin-Ressource kann zum privaten HTTP-Port einer Coolify-App weiterleiten. Wenn du stattdessen den Coolify-Traefik als zusätzlichen internen Router nutzt, müssen Hostheader, interne Erreichbarkeit und gegebenenfalls TLS/SNI sorgfältig konfiguriert werden.
Beachte, dass ein öffentliches DNS-Wildcard *.example.com nur ein eindeutiges Ziel haben kann, sofern du nicht spezifischere DNS-Einträge setzt. Für verschiedene Plattformen bieten sich etwa *.apps.example.com für Coolify und *.secure.example.com für Pangolin an – jeweils mit dafür passenden DNS-, Proxy- und Zertifikatsregeln.
10. Fehlerbehebung für häufige Coolify-Probleme
Installation oder Dashboard reagiert nicht
Prüfe den Port 8000, Docker und die Firewall auf Server und Provider-Ebene. Bereits belegte Ports sind eine verbreitete Ursache, insbesondere auf Homeservern mit anderen Anwendungen.
sudo ss -lntup | grep -E ":(8000|80|443)\b"
sudo docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
sudo docker logs --tail=100 coolify 2>&1Domain zeigt 404 oder „Bad Gateway“
Kontrolliere DNS-Ziel, Hostnamen der Ressource, Zustand des Proxys, Proxy-Netzwerk und korrekten Containerport. Eine funktionierende Docker-App ist nicht automatisch über den öffentlichen Hostnamen erreichbar. Bei Docker Compose muss außerdem der richtige Web-Service als Routing-Ziel gewählt sein.
Let’s Encrypt liefert kein Zertifikat
Verifiziere, dass die öffentliche Route den zuständigen Coolify-Proxy erreicht und dessen HTTP-/HTTPS-Challenge nicht von einem anderen Proxy, Cloudflare Tunnel oder einer Weiterleitung abgefangen wird. Für echte Wildcard-Zertifikate ist DNS-01 statt HTTP-01 nötig. Prüfe die konkreten Proxy-Logs.
Coolify zeigt eine falsche IP beim DNS-Check
Hinter aktiviertem Cloudflare-Proxy werden öffentliche Cloudflare-IPs angezeigt; Coolify unterstützt entsprechende validierte Fälle. Prüfe aber, ob die Anwendung beim richtigen Server ankommt und ob ein fehlerhafter AAAA-Eintrag auf einen nicht erreichbaren IPv6-Pfad zeigt.
11. Produktiv-Betrieb: Sicherheit und Backups
- Admin-Registrierung sofort abschließen und MFA verwenden; die Oberfläche über eine eigene HTTPS-Domain beziehungsweise einen geschützten Zugang betreiben.
- Firewall: öffentlichen Zugriff auf 8000/6001/6002 nach erfolgreicher Domain-Einrichtung möglichst schließen; SSH und benötigte Infrastrukturports bewusst freigeben.
/data/coolify/source/.envund weitere Coolify-Daten mitsamt Datenbanken/Volumes gesichert halten.- Deployments zuerst in Staging testen, Versionsupdates dokumentieren und den Wiederherstellungsweg regelmäßig prüfen.
- Secrets niemals in Dockerfiles, Screenshots, öffentlichen GitHub-Repositories oder ungeschützten Logdateien speichern.
FAQ zu Coolify, Domain und Wildcard
Was ist der Unterschied zwischen Projekt und Ressource?
Ein Projekt organisiert deine Dienste und Umgebungen. Eine Ressource ist die konkrete App, Datenbank oder Docker-Compose-Anwendung innerhalb der Umgebung.
Kann ich jede Anwendung automatisch unter *.example.com veröffentlichen?
Wildcard-DNS vereinfacht die Namensauflösung; Coolify benötigt für eine tatsächlich erreichbare App weiterhin eine zugewiesene Domain-Route und den richtigen Containerport. Ein Zertifikat für alle Subdomains erfordert gesonderte TLS-Konfiguration.
Kann ich Coolify direkt unter TrueNAS SCALE installieren?
Coolify kann in geeigneten Linux-Umgebungen beziehungsweise über eine TrueNAS-App betrieben werden. Die TrueNAS-App hat aber ihren eigenen Update-, Netzwerk- und Persistenzmechanismus. Verwende das Installationsskript für einen normalen Linux-Host oder eine dafür vorgesehene VM, nicht als Ersatz für die bestehende TrueNAS-App-Verwaltung.
Passende weiterführende Anleitungen
- Pangolin installieren – privater Zugriff per Tunnel
- GeoMetrikks: Website-Traffic selbst auswerten
- Wildcard-DNS und Cloudflare richtig einrichten
Schreiben Sie einen Kommentar