Coolify ist eine Open-Source, selbst gehostete Alternative zu Heroku und Vercel, mit der du deine Server, Anwendungen und Datenbanken ganz easy verwalten kannst.
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.
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 vServer/Dedicated Server:
| Hardware | Minimum | Empfohlen |
|---|---|---|
| CPU | 2 vCPU Kerne | 4 vCPU Kerne |
| RAM | 2 GB | 4 GB+ |
| Festplattenspeicher | 30 GB | 50 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.
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
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
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.
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.
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 / Host | Typ | Wert | TTL |
|---|---|---|---|
@ | 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.
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.
