---
title: Kaeso auf DigitalOcean ausrollen
description: "Betreiben Sie Kaeso auf DigitalOcean App Platform mit dem Button Deploy to DigitalOcean, oder mit doctl und einem verwalteten Valkey für den Produktivbetrieb. Der eigene Edge der App leitet Konsole und APIs auf einer Domain."
url: https://kaeso.app/de/articles/deploy-kaeso-on-digitalocean
markdown: https://kaeso.app/de/articles/deploy-kaeso-on-digitalocean.md
language: de
alternates:
  en: https://kaeso.app/articles/deploy-kaeso-on-digitalocean.md
  zh-CN: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-digitalocean.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - Selbst hosten
  - digitalocean
  - Bereitstellung
  - Anleitung
image: https://kaeso.app/articles/deploy-kaeso-on-digitalocean/cover.jpg
index: https://kaeso.app/de/llms.txt
---

# Kaeso auf DigitalOcean ausrollen

Betreiben Sie Kaeso auf DigitalOcean App Platform mit dem Button Deploy to DigitalOcean, oder mit doctl und einem verwalteten Valkey für den Produktivbetrieb. Der eigene Edge der App leitet Konsole und APIs auf einer Domain.

> 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

App Platform von DigitalOcean betreibt Container hinter einem Edge, der TLS terminiert und nach Pfad weiterleitet. Kaeso nutzt diesen Edge direkt: Die App sendet die APIs an das Gateway und alles andere an die Konsole, sodass hier kein `kaeso-edge` läuft.

Das Repository hat zwei App-Specs. `.do/deploy.template.yaml` liest der Button **Deploy to DigitalOcean**, mit Valkey innerhalb der App. `.do/app.yaml` nutzt stattdessen eine verwaltete Valkey-Datenbank, und Sie legen sie mit `doctl` an. Nutzen Sie den Button, um Kaeso auszuprobieren, und `doctl` für eine Installation, die Sie behalten.

## Was Sie bekommen

| Komponente | Art | Größe |
| --- | --- | --- |
| `kaeso-gateway` | Dienst auf Port 8080, das Gateway-Image | `apps-s-1vcpu-2gb` |
| `kaeso-console` | Dienst auf Port 3000, das Konsolen-Image | `apps-s-1vcpu-0.5gb` |
| `kaeso-postgres` | Dev-Datenbank, PostgreSQL 18 | 512 MB |
| `kaeso-valkey` (Button) | Dienst auf Port 6379, nur für die Komponenten der App | `apps-s-1vcpu-0.5gb` |
| `kaeso-valkey` (`doctl`) | Verwaltete Valkey-Datenbank, zuerst angelegt | Nach Ihrer Wahl |

Der Edge leitet `/v1`, `/v1beta`, `/v2`, `/platform`, `/mcp`, `/oauth` und `/.well-known` an das Gateway und jeden anderen Pfad an die Konsole. Das Gateway vertraut `X-Forwarded-For` aus dem privaten Netz, in dem der Edge sitzt, und hält seine Metriken auf seiner Loopback-Adresse.

`KAESO_PUBLIC_URL` ist `${APP_URL}`, die primäre Adresse der App, und die Datenbankadressen kommen von den Datenbanken, sodass Sie keine davon eintippen.

## Die Werte zum Ausfüllen

| Wert | Was einzutragen ist |
| --- | --- |
| `KAESO_MASTER_KEYS` | Ein Hauptschlüssel, den Sie auch in einem Passwort-Manager aufbewahren |
| `KAESO_SETUP_EMAIL` | Ihre Adresse; das Gateway sendet den Einrichtungslink dorthin |
| `KAESO_SMTP_HOST`, `KAESO_SMTP_USER`, `KAESO_SMTP_PASSWORD`, `KAESO_SMTP_FROM` | Ihr SMTP-Server |
| `KAESO_CLICKHOUSE_URL` | Eine ClickHouse-HTTP-URL mit Benutzer und Passwort für Anfrageprotokolle, oder leer |

Erzeugen Sie den Hauptschlüssel mit Docker:

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

App Platform verschlüsselt einen `SECRET`-Wert, sobald sie ihn erhält.

## Mit dem Button ausrollen

1. Öffnen Sie [Deploy to DigitalOcean](https://cloud.digitalocean.com/apps/new?repo=https://github.com/logicplanes/kaeso/tree/prod&refcode=881255e24b11). App Platform liest die Spec vom Branch `prod`, der das neueste Release enthält.
2. Tragen Sie in den Umgebungsvariablen von `kaeso-gateway` die Werte oben ein, und wählen Sie, wenn Sie möchten, eine andere Region.
3. Legen Sie die App an, und warten Sie, bis ihr erstes Deployment läuft.
4. Öffnen Sie den einmaligen Einrichtungslink, den Ihnen das Gateway gesendet hat, und legen Sie den ersten Benutzer an.

Der Button kann nur Dev-Datenbanken anlegen, und die gibt es nur für PostgreSQL. Sein Valkey läuft deshalb als Dienst in der App, hält seine Daten innerhalb von 256 MB und verdrängt nie einen Schlüssel. Er beginnt bei jedem seiner Deployments leer, was für seinen Inhalt in Ordnung ist: Das Gateway baut Budgetzähler aus PostgreSQL wieder auf, und Ratenfenster beginnen neu. Die Dev-Datenbank hält allerdings keine Backups, also nutzen Sie für den Produktivbetrieb `doctl`, oder verlegen Sie die App auf einen verwalteten PostgreSQL-Cluster und einen verwalteten Valkey.

## Mit doctl ausrollen

Installieren Sie [`doctl`](https://docs.digitalocean.com/reference/doctl/), melden Sie sich an und legen Sie die Valkey-Datenbank in der Region der App an:

```bash
doctl auth init
doctl databases create kaeso-valkey --engine valkey --region fra1 --size db-s-1vcpu-1gb --num-nodes 1 --wait
```

Setzen Sie in den **Settings** der Datenbank **Eviction policy** auf **No eviction**, sodass eine volle Datenbank Schreibzugriffe ablehnt, statt Limitzähler zu verwerfen. Kopieren Sie dann `.do/app.yaml` aus dem Release, das Sie ausrollen, tragen Sie die Werte ein und legen Sie die App an:

```bash
doctl apps create --spec app.yaml --wait
```

Der verwaltete Valkey spricht TLS mit einem Zertifikat von DigitalOceans eigener Zertifizierungsstelle, das die Spec dem Gateway als `KAESO_VALKEY_CA` übergibt. Für eine Datenbank mit Backups legen Sie einen verwalteten PostgreSQL-Cluster an und richten `kaeso-postgres` mit `production: true` und seinem `cluster_name` darauf.

## Ihre eigene Domain

Aus dem Button: Fügen Sie die Domain in den **Settings** der App unter **Domains** hinzu, und richten Sie den DNS-Eintrag so ein, wie App Platform es angibt. `${APP_URL}` folgt der primären Domain, sodass das Gateway mit der neuen Adresse neu ausgerollt wird.

Aus `doctl`: Fügen Sie sie in der Spec unter `domains` mit `type: PRIMARY` hinzu, wenden Sie die Spec mit `doctl apps update` an, und richten Sie den DNS-Eintrag so ein, wie es der Tab **Networking** der App angibt.

## Aktualisieren und zurückrollen

Ein Release ändert die Image-Tags von `kaeso-gateway` und `kaeso-console`. Setzen Sie beide Tags in der Spec Ihrer App und wenden Sie sie an:

```bash
doctl apps spec get $APP_ID > app.yaml
doctl apps update $APP_ID --spec app.yaml --wait
```

Das Gateway migriert die Datenbanken beim Start, nur vorwärts. Zum Zurückrollen wählen Sie **Rollback** neben einem früheren Deployment im Tab **Activity** der App; App Platform behält die zehn letzten erfolgreichen Deployments.

## Was getestet wurde

Die Validierungs- und Proposal-API von App Platform hat die Spec des Buttons am 9. November 2026 angenommen. Kaeso wurde noch nicht aus einem leeren Konto auf DigitalOcean ausgerollt. Wenn Sie es tun, [sagen Sie uns](https://kaeso.app/de/contact), wie es lief.

## Nächste Schritte

- [DigitalOcean in den Docs](https://docs.kaeso.app/de/self-hosting/platforms/digitalocean), mit beiden Specs vollständig.
- [Backups und Hauptschlüssel](https://docs.kaeso.app/de/self-hosting/backups): Wechseln Sie auf einen verwalteten PostgreSQL-Cluster mit Backups.
- [Wo Sie Kaeso betreiben](https://kaeso.app/de/articles/where-to-run-kaeso): wie sich DigitalOcean mit den anderen Plattformen vergleicht.

Von Kaeso Team

## Weitere Artikel

- [Kaeso auf Railway ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-railway.md): Betreiben Sie Kaeso auf Railway mit dem Button Deploy on Railway, der den Hauptschlüssel für Sie erzeugt, oder aus der Infrastrukturdatei mit der Railway-CLI. Fünf Dienste, ein öffentlicher Edge, Railway Postgres und Redis.
- [Kaeso auf Fly.io ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-fly-io.md): Betreiben Sie Kaeso auf Fly.io als vier Apps im privaten Netz, einen Edge, ein Gateway, eine Konsole und Valkey, mit Fly Managed Postgres. Jeder Befehl, vom Anlegen der Apps bis zu Ihrem eigenen Zertifikat.

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