Zum Hauptinhalt springen

Coolify auf einem Linux-Server einrichten – Self-Hosted Cloud-Anwendungen

Die passenden Produkte für diese Anleitung

Lege direkt los — bestelle das passende Produkt und folge dieser Anleitung Schritt für Schritt.

Einführung​

Coolify ist eine Open-Source, selbst gehostete Alternative zu Heroku und Vercel, mit der du deine Server, Anwendungen und Datenbanken ganz easy verwalten kannst.

img

Das intuitive Dashboard von Coolify macht Self-Hosting zum Kinderspiel. Du hast volle Kontrolle über deine Infrastruktur, automatisierte GitHub-Deployments und hältst deine Cloud-Kosten niedrig.

In dieser Anleitung zeigen wir dir Schritt für Schritt, wie du Coolify einrichtest, deinen Admin-Account vorkonfigurierst und alles einstellst, was du wissen musst.

Anwendungsfälle von Coolify​

Coolify eignet sich für viele verschiedene Alltagsszenarien und ist perfekt für alle, die App-Deployments automatisieren, Datenbanken hosten oder Background-Worker betreiben wollen. Egal ob Anfänger oder Profi – Coolify ist für jeden was.

Coolify unterstützt out-of-the-box das Deployen von Static Sites, Node.js, Python, PHP, Rust und Docker-Containern. Es gibt coole One-Click-Templates wie WordPress, Ghost, Grafana, Appwrite, Nextcloud und PostgreSQL-Datenbanken. Außerdem kümmert es sich automatisch um Let's Encrypt SSL-Zertifikate und Reverse-Proxy-Routing via Traefik.

Vorbereitung​

Coolify ist zwar schlank, aber der Ressourcenverbrauch kann je nach Anzahl der deployten Apps, Docker-Builds und laufenden Datenbanken stark steigen. Wir empfehlen folgende Hardware-Anforderungen für Coolify auf deinem VPS/Dedicated Server:

HardwareMinimumEmpfohlen
CPU2 vCPU Kerne4 vCPU Kerne
RAM2 GB4 GB+
Festplattenspeicher30 GB50 GB+

Bevor du Coolify installierst, verbinde dich mit deinem Server und stelle sicher, dass das Betriebssystem aktuell ist. Du musst dich per SSH mit Root-Zugriff verbinden. Falls du Hilfe brauchst, haben wir eine Anleitung zum SSH-Erstzugang.

SSH-Key-Authentifizierung

Wir empfehlen dringend, statt Passwort eine SSH-Key-Authentifizierung einzurichten. Wie das geht, erfährst du in unserer SSH-Key Einrichtung Anleitung.

Installation​

Nachdem du dich mit deinem Server verbunden hast, aktualisiere deine Systempakete und installiere curl, das für das Herunterladen des Coolify-Installationsskripts benötigt wird:

sudo apt update && sudo apt upgrade -y && sudo apt install curl -y

Admin-Benutzer-Zugangsdaten vorbereiten​

Coolify setzt strenge Sicherheitsregeln für deinen Admin-Account durch. Bevor du das Installationsskript startest, bereite deine Root-User-Zugangsdaten nach diesen Vorgaben vor:

  • Benutzername
    • Mindestens 3 Zeichen lang
    • Maximal 255 Zeichen
    • Nur Buchstaben, Zahlen, Leerzeichen, Unterstriche und Bindestriche erlaubt
  • E-Mail
    • Muss eine gültige E-Mail-Adresse sein
    • Muss einen gültigen DNS-Eintrag haben
    • Maximal 255 Zeichen
  • Passwort
    • Mindestens 8 Zeichen lang
    • Muss Groß- und Kleinbuchstaben enthalten
    • Mindestens eine Zahl
    • Mindestens ein Sonderzeichen
    • Darf kein häufig genutztes oder kompromittiertes Passwort sein

Installationsskript ausführen​

Coolify bietet ein schnelles, automatisiertes Installationsskript. Um die Installation abzusichern, definieren wir die Root-Admin-Daten per Umgebungsvariablen vor. So wird unbefugter Zugriff während der Einrichtung verhindert.

Führe folgenden Befehl aus und ersetze Benutzername, E-Mail und Passwort durch deine sicheren Zugangsdaten:

env ROOT_USERNAME=zaphosting ROOT_USER_EMAIL=info@zap-hosting.com ROOT_USER_PASSWORD=zaphosting bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
Open Source

Den Quellcode des Installationsskripts findest du im offiziellen Coolify Repository

Das Skript installiert automatisch Docker, richtet die nötigen Netzwerke ein und konfiguriert die Coolify-Container. Je nach Server-Hardware kann das ein paar Minuten dauern.

img

Coolify aufrufen​

Nach der Installation kannst du das Dashboard im Browser öffnen. Gib die IP-Adresse deines Servers mit Port 8000 ein: http://[deine_server_ip]:8000

Da du deine Zugangsdaten schon beim Installationsbefehl angegeben hast, landest du direkt auf dem Login-Screen und nicht im Setup-Assistenten.

Melde dich mit der E-Mail und dem Passwort an, die du im Terminal verwendet hast.

DNS-Einträge einrichten​

Nach dem Login solltest du als erstes eine eigene Domain einrichten. Der Zugriff über die IP-Adresse (http://[deine_server_ip]:8000) ist unsicher.

Mit einer Domain kann Coolify automatisch kostenlose SSL-Zertifikate für dein Dashboard und alle zukünftigen Apps erstellen.

Gehe ins DNS-Management deines Domain-Anbieters und füge zwei neue A-Einträge hinzu, die auf deinen Server zeigen. Wenn deine Domain bei ZAP-Hosting registriert ist, hilft dir unsere Domain Records Anleitung beim Einrichten:

Name / HostTypWertTTL
@A[deine_server_ip]Auto / Niedrig
*A[deine_server_ip]Auto / Niedrig
DNS-Routing
  • Der @-Eintrag erlaubt Coolify, die Root-Domain zu nutzen
  • Der *-Wildcard-Eintrag sorgt dafür, dass Coolify automatisch alle neuen Subdomains (z.B. api.[deine_domain]) routet, ohne dass du für jedes Projekt DNS-Einträge anlegen musst.

Domain für die Instanz konfigurieren​

Um deine Coolify-Instanz mit einem SSL-Zertifikat abzusichern, solltest du ihr eine Domain zuweisen. Gehe im linken Menü auf Einstellungen und finde das Feld Instance Domain. Trage deine Domain inklusive https:// ein (z.B. https://coolify.[deine_domain]). Speichere die Änderung.

img

Deine erste App deployen​

Jetzt kannst du im Tab Projekte deine erste Anwendung deployen!

Klicke auf + Ressource hinzufügen, um ein öffentliches Repository oder eine Docker-Compose-Datei hinzuzufügen oder wähle einen der vielen vorkonfigurierten Services aus der One-Click-Template-Bibliothek. Deine Coolify-Installation ist startklar!

img

Abschluss und weitere Ressourcen​

Glückwunsch! Du hast Coolify erfolgreich auf deinem Server installiert und kannst direkt mit dem Deployen deiner Projekte loslegen. Schau dir auch diese Ressourcen an, die dir bei der Server-Konfiguration weiterhelfen können:

Du hast noch Fragen, die hier nicht beantwortet wurden? Unser Support-Team steht dir täglich zur Seite – melde dich einfach bei uns! 🙂