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! 🙂