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

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

> 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

Wenn Sie [Coolify](https://coolify.io) 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

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

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

   ```text
   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:

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

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:

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

## Nächste Schritte

- [Coolify in den Docs](https://docs.kaeso.app/de/self-hosting/platforms/coolify).
- [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 Coolify mit den anderen Plattformen vergleicht.

Von Kaeso Team

## Weitere Artikel

- [Kaeso auf Google Cloud ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-google-cloud.md): Zwei Terraform-Konfigurationen betreiben Kaeso auf Google Cloud. Der schnelle Server legt das Compose-Paket aus Cloud Shell auf eine Compute-Engine-Instanz; die verwaltete Konfiguration betreibt es auf Cloud Run mit Load Balancer, Cloud SQL und Memorystore.
- [Kaeso auf Dokploy ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-dokploy.md): 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.

[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)
