---
title: Kaeso auf Dokploy ausrollen
description: "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."
url: https://kaeso.app/de/articles/deploy-kaeso-on-dokploy
markdown: https://kaeso.app/de/articles/deploy-kaeso-on-dokploy.md
language: de
alternates:
  en: https://kaeso.app/articles/deploy-kaeso-on-dokploy.md
  zh-CN: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-dokploy.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - Selbst hosten
  - dokploy
  - Bereitstellung
  - Anleitung
image: https://kaeso.app/articles/deploy-kaeso-on-dokploy/cover.jpg
index: https://kaeso.app/de/llms.txt
---

# 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.

> Jede Seite, jeder Artikel und jede Seite der Doku von Kaeso steht in https://kaeso.app/de/llms.txt.

- Veröffentlicht: 11. November 2026
- Lesezeit: 3 Min.
- Autor: Kaeso Team

[Dokploy](https://dokploy.com) 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 bekommen

| 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.

## Ausrollen

**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:

```bash
curl -fsSLO https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/dokploy/docker-compose.yml
curl -fsSLO https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/dokploy/template.toml
jq -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`:

```bash
docker exec kaeso-example-gateway-1 kaeso setup-link
```

Das 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ückrollen

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 wissen

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

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](https://kaeso.app/de/contact), wie es lief.

## Nächste Schritte

- [Dokploy in den Docs](https://docs.kaeso.app/de/self-hosting/platforms/dokploy).
- [Backups und Hauptschlüssel](https://docs.kaeso.app/de/self-hosting/backups): Sichern Sie die Volumes auf Ihrem Server.
- [Wo Sie Kaeso betreiben](https://kaeso.app/de/articles/where-to-run-kaeso): wie sich Dokploy mit den anderen Plattformen vergleicht.

Von Kaeso Team

## Weitere Artikel

- [Kaeso auf Coolify ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-coolify.md): 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.
- [Kaeso auf CapRover ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-caprover.md): Betreiben Sie Kaeso auf Ihrem eigenen CapRover-Server als One-Click-App aus der Vorlage im Repository. Sechs Apps, ein öffentlicher Edge hinter dem nginx von CapRover, und PostgreSQL, ClickHouse und Valkey neben Kaeso.

[Alle Artikel ansehen](https://kaeso.app/de/articles.md)

## Ihr Gateway. Ihre Request-Logs

```bash
curl -fsSL https://kaeso.app/install.sh | sh
```

[Kaeso installieren](https://docs.kaeso.app/de/self-hosting/installation) · [Live-Demo öffnen](https://demo.kaeso.app)
