Kaeso auf Coolify ausrollen
Betreiben Sie Kaeso auf Ihrem eigenen Coolify-Server aus einer Compose-Datei. Coolify erzeugt jedes Passwort und den Hauptschlüssel, sein Proxy übernimmt TLS, und PostgreSQL, ClickHouse und Valkey laufen neben Kaeso.
- Veröffentlicht
- Lesezeit
- 3 Min.
- Autor
- Kaeso Team

Wenn Sie Coolify (öffnet in einem neuen Tab) bereits auf einem Ihrer Server betreiben, fügt sich Kaeso als eine weitere Ressource ein. deploy/coolify/compose.yaml im Repository ist eine Docker-Compose-Datei, die dafür gemacht ist: ein öffentlicher Edge hinter dem Proxy von Coolify, ein privates Gateway und eine private Konsole, und dieselben PostgreSQL, ClickHouse und Valkey, die das Compose-Paket betreibt, alle auf ein Release festgelegt.
Anders als bei den Cloud-Plattformen brauchen Sie hier keine externe Datenbank und kein externes ClickHouse: Alles läuft auf Ihrem Coolify-Server, Anfrageprotokolle eingeschlossen.
Was Sie bekommen01
edge- Image
- Das Konsolen-Image, das
kaeso-edgeausführt - Erreicht von
- Allen, über den Proxy von Coolify auf Ihrer Domain
gateway- Image
- Das Gateway-Image
- Erreicht von
- Dem Edge
console- Image
- Das Konsolen-Image
- Erreicht von
- Dem Edge
postgres,clickhouse,valkey- Image
- Die Releases, die das Compose-Paket betreibt
- Erreicht von
- Dem Gateway
| Dienst | Image | Erreicht von |
|---|---|---|
edge | Das Konsolen-Image, das kaeso-edge ausführt | Allen, über den Proxy von Coolify auf Ihrer Domain |
gateway | Das Gateway-Image | Dem Edge |
console | Das Konsolen-Image | Dem Edge |
postgres, clickhouse, valkey | Die Releases, die das Compose-Paket betreibt | Dem Gateway |
Jeder Dienst behält die Härtung des Compose-Pakets: keine neuen Privilegien, jede Linux-Capability entzogen bis auf die, die ein Datenspeicher braucht, ein schreibgeschütztes Root-Dateisystem für die eigenen Dienste von Kaeso, und Speicher- und Prozesslimits. Das Gateway meldet sich bei PostgreSQL als kaeso an, dem seine Datenbank gehört, der aber kein Superuser ist. Valkey verdrängt nie einen Schlüssel, sodass ein volles Valkey Schreibzugriffe ablehnt, statt Limitzähler zu verwerfen.
Coolify füllt jeden Wert, dessen Name mit SERVICE_ beginnt: SERVICE_URL_EDGE_8080 ist die Adresse des Edge, die Werte SERVICE_PASSWORD_… sind zufällige Passwörter, und SERVICE_REALBASE64_32_MASTERKEY sind 32 zufällige Bytes, der Hauptschlüssel.
Ausrollen02
- 01
Öffnen Sie in Coolify ein Projekt und fügen Sie eine Ressource vom Typ Docker Compose Empty hinzu. Fügen Sie die Datei vom Branch
prodein, der das neueste Release enthält:https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/coolify/compose.yaml - 02
Setzen Sie beim Dienst
edgedie Domain aufhttps://und Ihre Domain, etwahttps://kaeso.example.com, und richten Sie ihren DNS-Eintrag auf den Server. Kaeso braucht einehttps-Adresse. - 03
Tragen Sie unter Environment Variables Ihren SMTP-Server ein, falls Sie einen haben:
Variable Was einzutragen ist KAESO_MAIL_TRANSPORTsmtp, um E-Mails zu senden;log, der Standard, protokolliert nur die Art jeder E-MailKAESO_SETUP_EMAILIhre Adresse; mit SMTP sendet das Gateway den Einrichtungslink dorthin KAESO_SMTP_HOST,KAESO_SMTP_PORT,KAESO_SMTP_TLS,KAESO_SMTP_USER,KAESO_SMTP_PASSWORD,KAESO_SMTP_FROMIhr SMTP-Server - 04
Rollen Sie aus, und warten Sie, bis jeder Dienst gesund ist.
- 05
Kopieren Sie
SERVICE_REALBASE64_32_MASTERKEYaus Environment Variables in einen Passwort-Manager. Der Hauptschlüssel istk1:, gefolgt von diesem Wert. Kaeso verschlüsselt Anbieter-Schlüssel damit, sodass sich ein Backup der Datenbank ohne ihn nicht lesen lässt. - 06
Öffnen Sie den Einrichtungslink, um den ersten Benutzer anzulegen. Mit SMTP kommt er an
KAESO_SETUP_EMAIL. Ohne geben Sie ihn auf dem Server aus, in einem Terminal oder im Terminal von Coolify für den Server:docker exec $(docker ps --quiet --filter name=gateway-) kaeso setup-link
Das Gateway-Image hat keine Shell, also kann das Terminal von Coolify für den Container des Gateways den Befehl nicht ausführen; nutzen Sie das des Servers. Auf einem Server mit mehreren Kaeso-Ressourcen geben Sie docker exec den Gateway-Container, den docker ps für diese hier listet.
Aktualisieren und zurückrollen03
Ein Release ändert die Image-Tags in der Compose-Datei. Öffnen Sie die Compose-Datei der Ressource in Coolify, setzen Sie die Tags von edge, gateway und console auf das neue Release und rollen Sie aus; Coolify behält die erzeugten Werte. Das Gateway migriert die Datenbanken beim Start, nur vorwärts. Zum Zurückrollen setzen Sie die früheren Tags.
Gut zu wissen04
- Der Updater von Kaeso läuft hier nicht, die Konsole kann Kaeso also nicht aktualisieren. Sie rollen jedes Release in Coolify aus, das es an einer Stelle mit Ihren anderen Apps hält.
- Der Proxy von Coolify terminiert TLS. Das Gateway schreibt ein Keepalive in jeden Stream, sodass lange Streams das Leerlauf-Timeout des Proxys überdauern.
Was getestet wurde05
Die Datei lief am 9. November 2026 lokal mit Docker, mit gesunden Diensten, Pfadweiterleitung und dem Einrichtungslink. Auf einem Coolify-Server wurde sie noch nicht ausgerollt. Wenn Sie es tun, sagen Sie uns, wie es lief.
Nächste Schritte06
- Backups und Hauptschlüssel (öffnet in einem neuen Tab): Sichern Sie die Volumes auf Ihrem Server.
- Wo Sie Kaeso betreiben: wie sich Coolify mit den anderen Plattformen vergleicht.
Von Kaeso Team


