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

# Kaeso auf CapRover ausrollen

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.

> 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

[CapRover](https://caprover.com) installiert Apps aus One-Click-Vorlagen, und Sie können eine eigene einfügen. `deploy/caprover/kaeso.yml` im Kaeso-Repository ist eine solche Vorlage. Sie legt sechs Apps auf Ihrem CapRover-Server an: einen öffentlichen Edge hinter dem nginx von CapRover, ein privates Gateway und eine private Konsole, und PostgreSQL, ClickHouse und Valkey des Compose-Pakets, alle auf ein Release festgelegt.

## Was Sie bekommen

| App | Image | Erreicht von |
| --- | --- | --- |
| `kaeso` | Das Konsolen-Image, das `kaeso-edge` ausführt | Allen, über nginx auf der Domain der App |
| `kaeso-gateway` | Das Gateway-Image | Dem Edge |
| `kaeso-console` | Das Konsolen-Image | Dem Edge |
| `kaeso-postgres`, `kaeso-clickhouse`, `kaeso-valkey` | Die Releases, die das Compose-Paket betreibt | Dem Gateway |

Die Namen folgen dem App-Namen, den Sie angeben, hier `kaeso`. Nur der Edge ist eine Web-App; die anderen sind nur im Overlay-Netz von CapRover erreichbar. Das Gateway meldet sich bei PostgreSQL als `kaeso` an, dem seine Datenbank gehört, der aber kein Superuser ist. Valkey hält seine Daten innerhalb von 512 MB und verdrängt nie einen Schlüssel.

Das nginx von CapRover hängt an das `X-Forwarded-For` des Aufrufers an, also liest der Edge `X-Real-IP`, das nginx setzt, und das Gateway vertraut nur privaten Adressen. Die Vorlage schaltet die WebSocket-Unterstützung für den Edge ein, wodurch nginx mit ihm HTTP/1.1 spricht.

## Ausrollen

1. Erzeugen Sie einen Hauptschlüssel, und bewahren Sie ihn in einem Passwort-Manager auf:

   ```bash
   docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate
   ```

2. Öffnen Sie in CapRover **Apps**, dann **One-Click Apps/Databases**, und wählen Sie **>> TEMPLATE <<** am Ende der Liste.
3. Fügen Sie die Vorlage vom Branch `prod` ein, der das neueste Release enthält:

   ```text
   https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/caprover/kaeso.yml
   ```

4. Füllen Sie das Formular aus:

   | Feld | Was einzutragen ist |
   | --- | --- |
   | App name | `kaeso`, oder ein eigener Name |
   | Public URL | Die Adresse der App unter Ihrer Root-Domain, die das Formular einträgt, oder Ihre eigene Domain |
   | Master key | Der Schlüssel aus Schritt 1 |
   | Passwords | Zufällige, die das Formular einträgt |
   | Mail transport | `smtp`, um E-Mails zu senden; `log`, der Standard, protokolliert nur die Art jeder E-Mail |
   | Setup email, SMTP host, port, user, password, sender | Ihr SMTP-Server, falls Sie einen haben |

5. Rollen Sie aus, und warten Sie, bis die Apps angelegt sind. Das Gateway startet neu, bis PostgreSQL und Valkey antworten.
6. Öffnen Sie die App `kaeso`, schalten Sie **HTTPS** und **Force HTTPS** ein, und verbinden Sie Ihre Domain, wenn die öffentliche URL eine nennt.
7. Öffnen Sie den Einrichtungslink, um den ersten Benutzer anzulegen. Mit SMTP kommt er an die Einrichtungs-E-Mail-Adresse. Ohne geben Sie ihn auf dem Server aus:

   ```bash
   docker exec $(docker ps --quiet --filter name=srv-captain--kaeso-gateway) kaeso setup-link
   ```

## Aktualisieren und zurückrollen

Ein Release ändert die Image-Tags in `kaeso.yml`. Öffnen Sie in jeder der Apps `kaeso-gateway`, `kaeso-console` und `kaeso` den Bereich **Deployment** und rollen Sie per Image-Name mit dem neuen Tag aus, etwa `ghcr.io/logicplanes/kaeso-gateway:0.6.0`, das Gateway zuerst. Das Gateway migriert die Datenbanken beim Start, nur vorwärts. Zum Zurückrollen rollen Sie das frühere Tag auf dieselbe Weise aus.

## Gut zu wissen

- CapRover liest aus einer One-Click-App nur einige Compose-Felder. Health-Checks, entzogene Capabilities, ein schreibgeschütztes Root-Dateisystem und Speicherlimits erreichen die Apps nicht, also laufen sie mit den Standards der Images. Wenn Sie die volle Härtung auf Ihrem eigenen Server möchten, bekommen Sie sie mit dem [Installationsskript](https://kaeso.app/de/articles/where-to-run-kaeso).
- nginx wartet standardmäßig 60 Sekunden auf eine Antwort. Streams senden Keepalives, aber eine Anfrage ohne Streaming, die länger dauert, bekommt `504`. Erhöhen Sie `proxy_read_timeout` in der nginx-Konfiguration der Edge-App, wenn Sie mehr brauchen.
- Der Updater von Kaeso läuft hier nicht; Sie rollen jedes Release in CapRover aus.

## Was getestet wurde

Die Vorlage lässt sich lesen und nutzt nur Felder, die CapRover liest. Auf einem CapRover-Server wurde sie noch nicht ausgerollt. Wenn Sie es tun, [sagen Sie uns](https://kaeso.app/de/contact), wie es lief.

## Nächste Schritte

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

Von Kaeso Team

## Weitere Artikel

- [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.
- [Wie Kaeso arbeitet, zeigt die Live-Demo](https://kaeso.app/de/articles/kaeso-demo.md): demo.kaeso.app öffnet mit einem Klick eine echte Kaeso-Konsole mit einer Beispielorganisation, ohne Konto und ohne Installation. Hier steht, was Sie sich ansehen können, wie sich die Demo verhält und wie Sie eine eigene betreiben.

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