Wo Sie Kaeso betreiben, vom eigenen Server bis zur verwalteten Cloud
Kaeso 0.6.0 läuft mit einem Befehl auf Ihrem eigenen Server und mit Vorlagen aus dem Repository auf zehn Plattformen. Ein Überblick über die vier Arten von Wegen, was jeder gleich hält und welchen Sie wählen.
- Veröffentlicht
- Lesezeit
- 4 Min.
- Autor
- Kaeso Team

Kaeso ist ein Gateway, das Sie selbst betreiben, also lautet die erste Frage: wo. Bis 0.6.0 war die Antwort ein Server mit Docker. Jetzt gibt es elf: Ihren eigenen Server mit einem Befehl, und zehn Plattformen mit Vorlagen im Kaeso-Repository (öffnet in einem neuen Tab), jede auf ein Release festgelegt.
Diese Anleitung ordnet sie nach der Art des Wegs, sagt, was jeder Weg gleich hält, und hilft Ihnen bei der Wahl. Jede Plattform hat eine eigene Anleitung, unten verlinkt.
Ihr eigener Server, mit einem Befehl01
Auf jedem Linux-Server oder Mac mit einer öffentlichen Domain:
curl -fsSL https://kaeso.app/install.sh | sh -s -- --domain kaeso.example.comDas Installationsskript lädt das neueste Release nach ./kaeso, schreibt seine Einstellungen und seinen Hauptschlüssel und startet das Compose-Paket: das Gateway, die Konsole, PostgreSQL, ClickHouse, Valkey, Caddy für TLS und den Updater. Es startet Docker, wenn es gestoppt ist, installiert es auf Wunsch unter Linux, prüft DNS-Eintrag und Zertifikat der Domain und gibt den Link aus, der den ersten Benutzer anlegt. Update in der Konsole funktioniert vom ersten Start an.
Diesen Weg sollten die meisten Installationen nehmen. Alles Folgende betreibt dasselbe Release auf der Infrastruktur anderer.
Vier Arten von Wegen02
- Plattformvorlage
- Was es ist
- Dateien, die die Plattform liest: ein öffentlicher Edge, ein privates Gateway und eine private Konsole, sowie PostgreSQL und Valkey der Plattform
- Plattformen
- Render, Railway, DigitalOcean, Fly.io
- Schneller Server
- Was es ist
- Eine virtuelle Maschine mit dem Compose-Paket, wie auf Ihrem eigenen Server
- Plattformen
- AWS, Azure, Google Cloud
- Verwalteter Betrieb
- Was es ist
- Die Container, der Load Balancer, PostgreSQL und Valkey der Cloud, mit Geheimnissen in ihrem Secret Store
- Plattformen
- AWS, Google Cloud
- Selbst betriebene Plattform
- Was es ist
- Eine Compose-Datei oder One-Click-App auf Ihrem eigenen Server, hinter dem Proxy der Plattform
| Weg | Was es ist | Plattformen |
|---|---|---|
| Plattformvorlage | Dateien, die die Plattform liest: ein öffentlicher Edge, ein privates Gateway und eine private Konsole, sowie PostgreSQL und Valkey der Plattform | Render, Railway, DigitalOcean, Fly.io |
| Schneller Server | Eine virtuelle Maschine mit dem Compose-Paket, wie auf Ihrem eigenen Server | AWS, Azure, Google Cloud |
| Verwalteter Betrieb | Die Container, der Load Balancer, PostgreSQL und Valkey der Cloud, mit Geheimnissen in ihrem Secret Store | AWS, Google Cloud |
| Selbst betriebene Plattform | Eine Compose-Datei oder One-Click-App auf Ihrem eigenen Server, hinter dem Proxy der Plattform | Coolify, Dokploy, CapRover |
Welchen Sie wählen
- Sie möchten Kaeso betreiben, ohne einen eigenen Server: eine Plattformvorlage. Render und Railway legen alles über einen Button an; DigitalOcean ebenso, mit einem Valkey in der App.
- Sie möchten das vollständige Compose-Paket, mit dem Updater und Anfrageprotokollen in einem gebündelten ClickHouse, in einem Cloud-Konto, das Sie bereits haben: ein schneller Server auf AWS, Azure oder Google Cloud.
- Sie erwarten echten Verkehr und möchten, dass die Cloud die Datenbanken hält: die verwalteten Stacks auf AWS (ECS Fargate, RDS, ElastiCache) oder Google Cloud (Cloud Run, Cloud SQL, Memorystore). Sie verlangen eine Region, eine Domain, ein Zertifikat und Größen, sind also kein Ein-Klick-Weg.
- Sie betreiben bereits Coolify, Dokploy oder CapRover: Nutzen Sie deren Vorlagen, und Kaeso lebt neben Ihren anderen Apps.
Was jeder Weg gleich hält03
Was Sie auch wählen, eine Installation verhält sich gleich:
- Ein Ursprung. Konsole und APIs antworten auf einer Domain.
/v1,/v1beta,/v2,/platform,/mcp,/oauthund/.well-known/oauth-*erreichen das Gateway, jeder andere Pfad die Konsole. Auf den meisten Plattformen übernimmt diese Weiterleitungkaeso-edge, ein zweiter Befehl im Konsolen-Image; auf DigitalOcean die Ingress-Regeln der App, bei den verwalteten Stacks der Load Balancer, auf einem schnellen Server Caddy. - Streams bleiben ungepuffert. Der Edge leitet jeden Chunk sofort weiter, und Load Balancer warten länger als das Keepalive-Intervall des Gateways.
- Client-Adressen werden nur dem Proxy der Plattform geglaubt. Der Edge liest die Adresse aus einem Header, den der Proxy setzt und den ein Aufrufer nicht fälschen kann, und das Gateway vertraut allein dem Edge.
- Health-Checks nutzen
/healthzfür den Prozess und/readyzfür PostgreSQL, Valkey und ClickHouse. Der Metrik-Port ist nie öffentlich. - Eine Version. Gateway, Konsole und Edge sind auf dasselbe Release festgelegt, und ein Release aktualisiert die Vorlagen.
Auf Plattformen ist der eigene Updater von Kaeso aus: Die Plattform rollt ein Release aus und zurück. Die Datenbankmigrationen eines Releases laufen nur vorwärts, sodass ein Zurückrollen über eine hinweg bleibt, wo es ist, wie auf jeder Installation.
Was jeder Weg braucht04
| Bedarf | Wie |
|---|---|
| Ein Hauptschlüssel | docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate, aufbewahrt im Secret Store der Plattform und in einem Passwort-Manager. Einige Vorlagen erzeugen ihn für Sie |
| Ein SMTP-Server. Kaeso sendet Anmeldelinks, Einladungen und Warnungen per E-Mail | |
| Der erste Benutzer | KAESO_SETUP_EMAIL: Das Gateway sendet den einmaligen Einrichtungslink bei jedem Start per E-Mail, bis der erste Benutzer existiert, denn das Gateway-Image hat keine Shell |
| Anfrageprotokolle | Ein externes ClickHouse, etwa ClickHouse Cloud, in KAESO_CLICKHOUSE_URL. Ohne es sind Anfrageprotokolle aus, und Nutzung, Limits und Budgets funktionieren gleich |
| Eine öffentliche Adresse | KAESO_PUBLIC_URL, die https-Adresse, die Personen und Apps nutzen |
Kaeso verschlüsselt Anbieter-Schlüssel mit dem Hauptschlüssel, sodass sich ein Datenbank-Backup ohne ihn nicht lesen lässt. Bewahren Sie eine Kopie außerhalb der Plattform auf.
Was getestet wurde05
Jede Anleitung sagt ehrlich, welche Teile live ausgerollt und welche nur geprüft wurden. Kurz gesagt: Der Render-Blueprint, der Railway-Button und die Railway-Datei sowie die schnellen Server auf AWS und Google Cloud wurden während der Release-Kandidaten aus leeren Konten ausgerollt. Der Edge, die Coolify-Datei und die Dokploy-Vorlage liefen lokal mit Docker. Die Spec für DigitalOcean bestand die Validierung von App Platform, die Fly.io-Dateien das Schema für fly.toml, die Azure-Vorlage das Template Toolkit von Microsoft und die verwalteten Stacks die Linter in CI. Die Seite der Plattformen in den Docs (öffnet in einem neuen Tab) führt das vollständige Protokoll.
Wenn Sie auf einer Plattform ausrollen, deren Live-Test noch aussteht, hören wir gern, wie es lief: Sagen Sie es uns, oder eröffnen Sie ein Issue auf GitHub (öffnet in einem neuen Tab).
Von Kaeso Team


