Kaeso auf Dokploy ausrollen
Betreiben Sie Kaeso auf Ihrem eigenen Dokploy-Server, indem Sie seine Vorlage importieren. Traefik übernimmt TLS, die Vorlage erzeugt jedes Passwort und den Hauptschlüssel, und PostgreSQL, ClickHouse und Valkey laufen neben Kaeso.
- Veröffentlicht
- Lesezeit
- 3 Min.
- Autor
- Kaeso Team

Dokploy (öffnet in einem neuen Tab) importiert Vorlagen als Compose-Datei und Konfiguration zusammen. deploy/dokploy/ im Kaeso-Repository enthält beide, docker-compose.yml und template.toml, im Format der eigenen Vorlagensammlung von Dokploy. Sie betreiben einen öffentlichen Edge hinter dem Traefik von Dokploy, ein privates Gateway und eine private Konsole, und PostgreSQL, ClickHouse und Valkey des Compose-Pakets auf Ihrem Server, alle auf ein Release festgelegt.
Was Sie bekommen01
edge- Image
- Das Konsolen-Image, das
kaeso-edgeausführt - Erreicht von
- Allen, über Traefik auf der Domain der Vorlage
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 Traefik auf der Domain der Vorlage |
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.
template.toml gibt dem Edge eine Domain auf Port 8080 und setzt die Umgebung: zufällige Passwörter aus dem Helfer hash von Dokploy und einen Hauptschlüssel aus 32 zufälligen Bytes aus seinem Helfer base64. E-Mails werden nur protokolliert, bis Sie einen SMTP-Server hinzufügen.
Ausrollen02
1. Erzeugen Sie den Importtext. Wandeln Sie auf einem Rechner mit curl und jq die Vorlage des Branches prod, der das neueste Release enthält, in den Base64-Text um, den Dokploy importiert:
curl -fsSLO https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/dokploy/docker-compose.ymlcurl -fsSLO https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/dokploy/template.tomljq -n --rawfile compose docker-compose.yml --rawfile config template.toml \ '{compose: $compose, config: $config}' | base64 | tr -d '\n'2. Importieren Sie ihn. Öffnen Sie in Dokploy ein Projekt und legen Sie einen Dienst vom Typ Compose an. Fügen Sie unter Advanced den Text bei Import ein. Dokploy zeigt die Compose-Datei, die Umgebung, die Mounts und die Domain, bevor es sie anwendet.
3. Setzen Sie die Domain. Ändern Sie unter Domains den Host auf Ihre Domain, etwa kaeso.example.com, schalten Sie HTTPS mit Let's Encrypt ein, und richten Sie den DNS-Eintrag der Domain auf den Server.
4. Füllen Sie die Umgebung aus. Setzen Sie unter Environment KAESO_PUBLIC_URL auf https:// und diese Domain, und fügen Sie Ihren SMTP-Server hinzu, falls Sie einen haben:
| Variable | Was einzutragen ist |
|---|---|
KAESO_MAIL_TRANSPORT | smtp, um E-Mails zu senden; log, der Standard, protokolliert nur die Art jeder E-Mail |
KAESO_SETUP_EMAIL | Ihre 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_FROM | Ihr SMTP-Server |
5. Rollen Sie aus, und warten Sie, bis jeder Dienst gesund ist.
6. Bewahren Sie den Hauptschlüssel auf. Kopieren Sie KAESO_MASTER_KEYS aus Environment in einen Passwort-Manager. Kaeso verschlüsselt Anbieter-Schlüssel damit, sodass sich ein Backup der Datenbank ohne ihn nicht lesen lässt.
7. Legen Sie den ersten Benutzer an, mit dem Einrichtungslink. Mit SMTP kommt er an KAESO_SETUP_EMAIL. Ohne geben Sie ihn auf dem Server aus, mit dem App-Namen des Dienstes aus seinem Tab General anstelle von kaeso-example:
docker exec kaeso-example-gateway-1 kaeso setup-linkDas Gateway-Image hat keine Shell, also kann das Terminal von Dokploy für den Container des Gateways den Befehl nicht ausführen; nutzen Sie das des Servers.
Aktualisieren und zurückrollen03
Ein Release ändert die Image-Tags in docker-compose.yml. Öffnen Sie die Compose-Datei des Dienstes in Dokploy, setzen Sie die Tags von edge, gateway und console auf das neue Release und rollen Sie aus; die Umgebung bleibt. 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 Dokploy aus.
- Traefik terminiert TLS. Das Gateway schreibt ein Keepalive in jeden Stream, sodass lange Streams das Leerlauf-Timeout des Proxys überdauern.
Was getestet wurde05
Die Compose-Datei der Vorlage lief am 9. November 2026 lokal mit Docker, mit gesunden Diensten, Pfadweiterleitung und dem Einrichtungslink. Auf einem Dokploy-Server wurde sie noch nicht importiert. 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 Dokploy mit den anderen Plattformen vergleicht.
Von Kaeso Team


