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

# Kaeso auf Fly.io ausrollen

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.

> 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

Fly.io betreibt eine App pro `fly.toml`, und Kaeso braucht vier. `deploy/fly/` im Repository enthält eine Fly-Launch-Konfiguration für jede, festgelegt auf ein Release, und Fly Managed Postgres hält die Datenbank. Fly hat keinen Deploy-Button für ein Projekt aus mehreren Apps, also besteht diese Anleitung aus einer Handvoll `fly`-Befehlen.

## Was Sie bekommen

| App | Datei | Image | Maschine |
| --- | --- | --- | --- |
| `…-edge` | `edge.toml` | Das Konsolen-Image, das `kaeso-edge` ausführt | `shared-cpu-1x`, 256 MB |
| `…-gateway` | `gateway.toml` | Das Gateway-Image | `shared-cpu-2x`, 2 GB |
| `…-console` | `console.toml` | Das Konsolen-Image | `shared-cpu-1x`, 256 MB |
| `…-valkey` | `valkey.toml` | Valkey, auf einem Volume von 1 GB | `shared-cpu-1x`, 512 MB |

Nur der Edge hat einen öffentlichen Dienst. Die anderen sind nur unter `<app>.internal` im privaten Netz Ihrer Organisation erreichbar, das IPv6 ist, also lauscht das Gateway auf `[::]:8080`. Der Edge liest `Fly-Client-IP`, das der Proxy von Fly setzt, statt des vom Aufrufer kontrollierten `X-Forwarded-For`.

Valkey hält seine Daten innerhalb von 256 MB und verdrängt nie einen Schlüssel, sodass ein volles Valkey Schreibzugriffe ablehnt, statt Limitzähler zu verwerfen. Es läuft auf einer Maschine mit einem Volume, das Fly nicht repliziert. Für seinen Inhalt ist das vertretbar: Das Gateway baut Budgetzähler aus PostgreSQL wieder auf, und Ratenfenster beginnen neu.

## Ausrollen

**1. Erzeugen Sie einen Hauptschlüssel** in eine Variable, und kopieren Sie, was `echo` ausgibt, in einen Passwort-Manager:

```bash
export KAESO_MASTER_KEYS=$(docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate)
echo $KAESO_MASTER_KEYS
```

**2. Melden Sie sich an und klonen Sie** den Branch `prod`, der das neueste Release enthält:

```bash
fly auth login
git clone --branch prod https://github.com/logicplanes/kaeso.git
cd kaeso
```

**3. Legen Sie die vier Apps an.** App-Namen sind auf Fly.io eindeutig, also wählen Sie ein eigenes Präfix:

```bash
export KAESO_APP=kaeso-example
fly apps create $KAESO_APP-edge
fly apps create $KAESO_APP-gateway
fly apps create $KAESO_APP-console
fly apps create $KAESO_APP-valkey
```

**4. Legen Sie die Datenbank** in der Region der Apps an, und hängen Sie sie an das Gateway. `fly mpg list` zeigt die ID des Clusters:

```bash
fly mpg create --name $KAESO_APP --region fra --pg-major-version 17
fly mpg attach $CLUSTER_ID --app $KAESO_APP-gateway --variable-name KAESO_POSTGRES_URL
```

**5. Setzen Sie die Secrets**, mit Ihrem SMTP-Server anstelle der Beispiele:

```bash
export VALKEY_PASSWORD=$(openssl rand -hex 24)
fly secrets set --stage --app $KAESO_APP-valkey VALKEY_PASSWORD=$VALKEY_PASSWORD
fly secrets set --stage --app $KAESO_APP-edge \
  KAESO_GATEWAY_UPSTREAM=$KAESO_APP-gateway.internal:8080 \
  KAESO_CONSOLE_UPSTREAM=$KAESO_APP-console.internal:3000
fly secrets set --stage --app $KAESO_APP-gateway \
  KAESO_PUBLIC_URL=https://$KAESO_APP-edge.fly.dev \
  KAESO_VALKEY_URL=redis://:$VALKEY_PASSWORD@$KAESO_APP-valkey.internal:6379 \
  KAESO_MASTER_KEYS="$KAESO_MASTER_KEYS" \
  KAESO_SETUP_EMAIL=owner@example.com KAESO_SMTP_HOST=smtp.example.com KAESO_SMTP_USER=kaeso \
  KAESO_SMTP_PASSWORD=secret KAESO_SMTP_FROM="Kaeso <kaeso@example.com>"
```

**6. Rollen Sie aus**: Valkey und die Konsole als je eine Maschine, dann das Gateway und den Edge:

```bash
fly deploy --config deploy/fly/valkey.toml --app $KAESO_APP-valkey --ha=false
fly deploy --config deploy/fly/console.toml --app $KAESO_APP-console --ha=false
fly deploy --config deploy/fly/gateway.toml --app $KAESO_APP-gateway
fly deploy --config deploy/fly/edge.toml --app $KAESO_APP-edge
```

**7. Legen Sie den ersten Benutzer an**, mit dem einmaligen Einrichtungslink, den das Gateway an `KAESO_SETUP_EMAIL` sendet. Das Gateway-Image hat keine Shell; kommt die E-Mail nicht an, lesen Sie also den SMTP-Fehler in den Protokollen des Gateways, korrigieren Sie die Secrets, und das Gateway sendet bei seinem nächsten Start einen neuen Link.

Für Anfrageprotokolle setzen Sie `KAESO_CLICKHOUSE_URL` beim Gateway auf eine ClickHouse-HTTP-URL, etwa von ClickHouse Cloud. Ohne sie sind Anfrageprotokolle aus, und Nutzung, Limits und Budgets funktionieren gleich.

## Ihre eigene Domain

Fügen Sie dem Edge ein Zertifikat hinzu, richten Sie die DNS-Einträge so ein, wie `fly certs add` es angibt, und geben Sie dem Gateway die neue Adresse:

```bash
fly certs add kaeso.example.com --app $KAESO_APP-edge
fly secrets set --app $KAESO_APP-gateway KAESO_PUBLIC_URL=https://kaeso.example.com
```

## Aktualisieren und zurückrollen

Ein Release ändert die Image-Tags in `edge.toml`, `gateway.toml` und `console.toml`. Holen Sie `prod`, und rollen Sie das Gateway, dann die Konsole und den Edge mit den Befehlen aus Schritt 6 aus. Das Gateway migriert die Datenbank beim Start, nur vorwärts, und eine Maschine bekommt 75 Sekunden, um sich zu leeren, wenn sie stoppt. Zum Zurückrollen rollen Sie ein früheres Image aus:

```bash
fly deploy --config deploy/fly/gateway.toml --app $KAESO_APP-gateway \
  --image ghcr.io/logicplanes/kaeso-gateway:0.6.0
```

## Gut zu wissen

- Fly Machines haben kein schreibgeschütztes Root-Dateisystem und keine Einstellung, um Linux-Capabilities zu entziehen, also laufen die Apps nur mit den Benutzern der Images.
- Managed Postgres bietet PostgreSQL 16 und 17, während das Compose-Paket 18 betreibt. Kaeso läuft auf 17, wie auf Google Cloud.
- Das Gateway vertraut jeder Adresse im privaten Netz der Organisation. Betreiben Sie Kaeso in einer eigenen Organisation, wenn andere Apps dort die Client-Adresse, die das Gateway protokolliert, nicht setzen können sollen.

## Was getestet wurde

Die Dateien bestehen das SchemaStore-Schema für `fly.toml`, und Weiterleitung, Streaming und Umgang mit Client-Adressen des Edge bestehen die lokalen Edge-Tests. Kaeso wurde noch nicht aus einem leeren Konto auf Fly.io ausgerollt. Wenn Sie es tun, [sagen Sie uns](https://kaeso.app/de/contact), wie es lief.

## Nächste Schritte

- [Fly.io in den Docs](https://docs.kaeso.app/de/self-hosting/platforms/fly), mit den Dateien erklärt.
- [Backups und Hauptschlüssel](https://docs.kaeso.app/de/self-hosting/backups): Sichern Sie Managed Postgres und bewahren Sie den Hauptschlüssel außerhalb von Fly.io auf.
- [Wo Sie Kaeso betreiben](https://kaeso.app/de/articles/where-to-run-kaeso): wie sich Fly.io mit den anderen Plattformen vergleicht.

Von Kaeso Team

## Weitere Artikel

- [Kaeso auf DigitalOcean ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-digitalocean.md): 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.
- [Kaeso auf AWS ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-aws.md): Zwei CloudFormation-Vorlagen betreiben Kaeso auf AWS. Der schnelle Server legt das Compose-Paket mit einem Klick auf eine Graviton-Instanz; der verwaltete Stack betreibt es auf ECS Fargate mit Application Load Balancer, RDS und ElastiCache.

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