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

# Kaeso auf AWS ausrollen

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.

> 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

`deploy/aws/` im Kaeso-Repository enthält zwei CloudFormation-Vorlagen für zwei verschiedene Bedürfnisse. Der **schnelle Server** ist das Compose-Paket auf einer EC2-Instanz, genau wie auf Ihrem eigenen Server, und startet mit einem Klick. Der **verwaltete Stack** betreibt Kaeso auf ECS Fargate mit den eigenen Datenspeichern von AWS, für Installationen, denen eine Maschine nicht mehr reicht.

Jedes Release lädt beide Vorlagen nach `https://kaeso-cloudformation.s3.amazonaws.com/vX.Y.Z/` hoch, und ein stabiles Release auch nach `latest/`.

## Der schnelle Server

[Launch on AWS](https://console.aws.amazon.com/cloudformation/home#/stacks/create/review?templateURL=https%3A%2F%2Fkaeso-cloudformation.s3.amazonaws.com%2Flatest%2Fquick-server.yaml&stackName=kaeso) öffnet die veröffentlichte Vorlage in CloudFormation. Sie legt an:

- eine Graviton-Instanz mit Ubuntu 24.04, standardmäßig `t4g.medium` mit einer 40-GB-Festplatte;
- eine Elastic IP und eine Sicherheitsgruppe für HTTP, HTTPS und HTTP/3, mit SSH nur aus einem Adressbereich, den Sie wählen;
- einen optionalen Route-53-Eintrag für Ihre Domain.

Beim ersten Start führt die Instanz das Installationsskript von Kaeso aus. Es installiert Docker, schreibt die Einstellungen, erzeugt den Hauptschlüssel und startet das Compose-Paket mit Caddy, einem gebündelten ClickHouse für Anfrageprotokolle und dem Updater. So funktioniert **Update** in der Konsole, wie auf jeder Compose-Installation.

Über die CLI, mit einem Klon des Repositorys:

```bash
aws cloudformation deploy --stack-name kaeso --template-file deploy/aws/quick-server.yaml \
  --parameter-overrides Domain=kaeso.example.com KeyName=my-key \
  AllowedSshCidr=203.0.113.0/24 HostedZoneId=Z0123456789
```

| Parameter | Was er ist |
| --- | --- |
| `Domain` | Die Domain, auf der Kaeso antwortet; ohne `HostedZoneId` richten Sie ihren A-Eintrag auf die Ausgabe `PublicIp` |
| `KaesoVersion` | Ein Release, das installiert wird; leer installiert das neueste stabile Release |
| `InstanceType`, `DiskSizeGb` | Standardmäßig `t4g.medium` und 40 GB |
| `KeyName`, `AllowedSshCidr` | SSH-Zugang, den `kaeso setup-link` braucht |
| `HostedZoneId` | Eine Route-53-Zone der Domain, um ihren Eintrag anzulegen |

Sobald der Stack fertig ist und Caddy sein Zertifikat hat, führen Sie die Ausgabe `SetupLink` über SSH aus. Sie gibt den einmaligen Link aus, der den ersten Benutzer anlegt.

## Der verwaltete Stack

`deploy/aws/managed.yaml` baut Kaeso aus AWS-Diensten:

- eine VPC mit zwei öffentlichen und zwei privaten Subnetzen und einem NAT-Gateway;
- einen Application Load Balancer mit Ihrem ACM-Zertifikat, HTTP auf HTTPS umgeleitet, Pfadregeln, die die APIs, den MCP-Server und seine Anmeldung an das Gateway und alles andere an die Konsole senden, und einem Leerlauf-Timeout von 300 Sekunden für lange Streams;
- einen ECS-Cluster auf Fargate mit Graviton, in den privaten Subnetzen: einen Gateway-Dienst mit standardmäßig 2 Tasks zu je 2 vCPUs und 4 GB, und einen Konsolen-Dienst;
- RDS PostgreSQL 18 und ElastiCache Valkey mit `noeviction`, TLS und einem AUTH-Token, beide nur vom Gateway erreichbar;
- Secrets-Manager-Secrets für die Hauptschlüssel, das Datenbankpasswort, das Valkey-Token, das SMTP-Passwort und die ClickHouse-URL;
- CloudWatch-Log-Gruppen und einen optionalen Route-53-Alias.

```bash
aws cloudformation deploy --stack-name kaeso --template-file deploy/aws/managed.yaml \
  --capabilities CAPABILITY_IAM --parameter-overrides \
  Domain=kaeso.example.com \
  CertificateArn=arn:aws:acm:eu-central-1:123456789012:certificate/example \
  MasterKeys="$(docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate)" \
  SetupEmail=owner@example.com SmtpHost=smtp.example.com SmtpUser=kaeso \
  SmtpPassword=secret SmtpFrom="Kaeso <kaeso@example.com>"
```

Bewahren Sie eine Kopie des Hauptschlüssels auch in einem Passwort-Manager auf: Kaeso verschlüsselt Anbieter-Schlüssel damit. Weitere Parameter bestimmen die Größe des Stacks: `GatewayCpu`, `GatewayMemory` und `GatewayCount` für das Gateway, und `DatabaseInstanceClass`, `DatabaseStorageGb` und `CacheNodeType` für die Datenspeicher. Mehrere Gateway-Tasks teilen Limits, Caches und die Wartezeiten der Routen über Valkey. Für Anfrageprotokolle setzen Sie `ClickHouseUrl` auf ein ClickHouse wie ClickHouse Cloud; leer lässt sie aus.

Das Gateway sendet den einmaligen Einrichtungslink an `SetupEmail`, bis der erste Benutzer existiert. Es vertraut `X-Forwarded-For` nur aus der VPC, in der die Knoten des Load Balancers sitzen. Der Load Balancer prüft `/readyz` beim Gateway und `/healthz` bei der Konsole, und ein Gateway-Task bekommt 75 Sekunden, um sich zu leeren, wenn er stoppt.

## Aktualisieren und zurückrollen

Auf dem schnellen Server aktualisieren Sie aus der Konsole, automatisch in einem Zeitfenster Ihrer Wahl oder von Hand, wie auf jeder Compose-Installation. Die Vorlage erneut auszurollen aktualisiert Kaeso nicht.

Beim verwalteten Stack ändert ein Release die Image-Tags in `managed.yaml`. Rollen Sie die neue Vorlage über den Stack aus: ECS ersetzt die Tasks mit einem Circuit Breaker, der bei einem Fehler zurückrollt, und das Gateway migriert die Datenbanken beim Start, nur vorwärts. Um absichtlich zurückzurollen, rollen Sie die Vorlage des vorherigen Releases aus.

## Was getestet wurde

Am 7. November 2026 wurde der schnelle Server als CloudFormation-Stack in `us-east-1` aus einem leeren Konto gestartet, mit dem achten Release-Kandidaten. Er legte seinen ersten Benutzer an und bestand die Prüfungen für Weiterleitung, Streaming und Protokollierung, nachdem die Datei des Hauptschlüssels auf der Testinstanz wieder dem Installationsskript gehörte. Die Vorlage lässt diesen Besitz jetzt unverändert, aber die korrigierte Vorlage wurde noch nicht erneut aus einem leeren Konto ausgerollt. Der verwaltete Stack wird in CI gelintet und formatiert und wurde noch nicht ausgerollt.

## Nächste Schritte

- [AWS in den Docs](https://docs.kaeso.app/de/self-hosting/platforms/aws), mit jedem Parameter.
- [Mehrere Gateways](https://docs.kaeso.app/de/self-hosting/scaling): was ein, zwei und drei Gateways bedienen.
- [Wo Sie Kaeso betreiben](https://kaeso.app/de/articles/where-to-run-kaeso): wie sich AWS mit den anderen Plattformen vergleicht.

Von Kaeso Team

## Weitere Artikel

- [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.
- [Kaeso auf Azure ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-azure.md): Betreiben Sie Kaeso auf einer virtuellen Maschine in Azure, mit dem Button Deploy to Azure oder der Azure CLI. Das Installationsskript läuft beim ersten Start, und der Einrichtungslink kommt über Cloud Shell, ohne SSH.

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