Zum Inhalt springen

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
Ein blasser Verlauf aus Orange und Gelb, in sanften waagerechten Falten

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 bekommen

  • edge
    Image
    Das Konsolen-Image, das kaeso-edge ausfü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

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.

Ausrollen

  1. Ö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 prod ein, der das neueste Release enthält:

    https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/coolify/compose.yaml
  2. Setzen Sie beim Dienst edge die Domain auf https:// und Ihre Domain, etwa https://kaeso.example.com, und richten Sie ihren DNS-Eintrag auf den Server. Kaeso braucht eine https-Adresse.

  3. Tragen Sie unter Environment Variables Ihren SMTP-Server ein, falls Sie einen haben:

    VariableWas einzutragen ist
    KAESO_MAIL_TRANSPORTsmtp, um E-Mails zu senden; log, der Standard, protokolliert nur die Art jeder E-Mail
    KAESO_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
  4. Rollen Sie aus, und warten Sie, bis jeder Dienst gesund ist.

  5. Kopieren Sie SERVICE_REALBASE64_32_MASTERKEY aus Environment Variables in einen Passwort-Manager. Der Hauptschlüssel ist k1:, gefolgt von diesem Wert. Kaeso verschlüsselt Anbieter-Schlüssel damit, sodass sich ein Backup der Datenbank ohne ihn nicht lesen lässt.

  6. Ö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ückrollen

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 wissen

  • 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 wurde

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 Schritte

Von Kaeso Team

Auf dieser Seite

Ihr Gateway.Ihre Request-Logs.

curl -fsSLhttps://kaeso.app/install.sh | sh