---
title: Kaeso auf Render ausrollen
description: "Betreiben Sie Kaeso auf Render mit dem Blueprint aus dem Repository, mit öffentlichem Edge, privatem Gateway und privater Konsole, Render Postgres und Key Value. Schritt für Schritt, vom Hauptschlüssel bis zu Ihrer eigenen Domain."
url: https://kaeso.app/de/articles/deploy-kaeso-on-render
markdown: https://kaeso.app/de/articles/deploy-kaeso-on-render.md
language: de
alternates:
  en: https://kaeso.app/articles/deploy-kaeso-on-render.md
  zh-CN: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-render.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - Selbst hosten
  - render
  - Bereitstellung
  - Anleitung
image: https://kaeso.app/articles/deploy-kaeso-on-render/cover.jpg
index: https://kaeso.app/de/llms.txt
---

# Kaeso auf Render ausrollen

Betreiben Sie Kaeso auf Render mit dem Blueprint aus dem Repository, mit öffentlichem Edge, privatem Gateway und privater Konsole, Render Postgres und Key Value. Schritt für Schritt, vom Hauptschlüssel bis zu Ihrer eigenen 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

Render liest einen Blueprint, `render.yaml`, und legt jeden Dienst darin an. Das Repository von Kaeso hat einen im Wurzelverzeichnis, festgelegt auf das neueste Release. Er betreibt Kaeso auf fünf Render-Ressourcen, von denen nur eine öffentlich ist.

## Was Sie bekommen

| Dienst | Typ | Image | Plan |
| --- | --- | --- | --- |
| `kaeso-edge` | Web Service | Das Konsolen-Image, das `kaeso-edge` ausführt | 0,5 CPU, 512 MB |
| `kaeso-gateway` | Private Service | Das Gateway-Image | 2 CPU, 4 GB |
| `kaeso-console` | Private Service | Das Konsolen-Image | 0,5 CPU, 512 MB |
| `kaeso-valkey` | Key Value | Das von Render, mit `noeviction` | 256 MB |
| `kaeso-postgres` | Postgres | Das von Render, Version 18 | 1 CPU, 2 GB |

Nur der Edge ist öffentlich. Er sendet die APIs, den MCP-Server und seine Anmeldung an das Gateway und jeden anderen Pfad an die Konsole, über das private Netz von Render. Postgres und Key Value haben eine leere `ipAllowList`, sodass nur die Dienste sie erreichen. Jeder Dienst hat `autoDeployTrigger: off`: Render rollt nie bei einem Commit neu aus, und Ihre Installation bleibt auf dem Release, das Sie gewählt haben.

Ändern Sie einen Plan oder die Region im Blueprint, bevor Sie ihn anlegen; Render behält sie danach.

## Bevor Sie beginnen

Sie brauchen ein Render-Konto, einen SMTP-Server für die E-Mails von Kaeso und Docker auf Ihrem Rechner, um den Hauptschlüssel zu erzeugen:

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

Bewahren Sie den Schlüssel in einem Passwort-Manager auf. Kaeso verschlüsselt Anbieter-Schlüssel damit, sodass sich ein Datenbank-Backup ohne ihn nicht lesen lässt.

Für Anfrageprotokolle brauchen Sie außerdem ein ClickHouse, etwa ClickHouse Cloud. Ohne es sind Anfrageprotokolle aus, und Nutzung, Limits und Budgets funktionieren gleich.

## Ausrollen

1. Öffnen Sie [Deploy to Render](https://render.com/deploy?repo=https://github.com/logicplanes/kaeso/tree/prod). Es legt einen **Blueprint** aus dem Repository `logicplanes/kaeso` auf dem Branch `prod` an, der das neueste Release enthält.
2. Tragen Sie die Werte ein, die der Blueprint abfragt:

   | Wert | Was einzutragen ist |
   | --- | --- |
   | `KAESO_PUBLIC_URL` | `https://` und die Adresse des Edge, etwa `https://kaeso-edge.onrender.com` |
   | `KAESO_MASTER_KEYS` | Der Hauptschlüssel |
   | `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, oder leer |

3. Wenden Sie den Blueprint an, und warten Sie, bis jeder Dienst läuft.
4. Öffnen Sie den einmaligen Einrichtungslink, den das Gateway an `KAESO_SETUP_EMAIL` gesendet hat, und legen Sie den ersten Benutzer an. Das Gateway sendet bei jedem Start einen neuen Link, bis ein Benutzer existiert.

Fügen Sie dann in der Konsole einen Anbieter-Schlüssel hinzu, erstellen Sie einen Projektschlüssel und senden Sie eine erste Anfrage an `https://kaeso-edge.onrender.com/v1`.

## Ihre eigene Domain

Fügen Sie die Domain bei `kaeso-edge` unter **Settings** hinzu, und richten Sie ihren DNS-Eintrag so ein, wie Render es angibt. Setzen Sie dann `KAESO_PUBLIC_URL` bei `kaeso-gateway` auf `https://` und die Domain, und rollen Sie das Gateway neu aus.

## Wie Client-Adressen ehrlich bleiben

Limits, Protokolle und Audit-Einträge von Kaeso halten die Adresse des Clients fest, also darf sie nichts sein, was sich ein Aufrufer ausdenken kann. Öffentlicher Verkehr erreicht vor Render Cloudflare, und Render hängt an das `X-Forwarded-For` des Aufrufers an, statt es zu ersetzen. Der Edge liest deshalb `CF-Connecting-IP`, das Cloudflare überschreibt, und sendet dem Gateway eine Adresse. Das Gateway vertraut allein dem Edge.

Das Gateway lauscht auf Port 8080 und hält seine Metriken auf seiner Loopback-Adresse, denn Render nimmt den einen Port, den ein Private Service auf allen Schnittstellen bindet, als seinen Port.

## Aktualisieren und zurückrollen

Ein Release ändert die Image-Tags in `render.yaml` auf `prod`. Auf der Seite des Blueprints rollt **Manual sync** die Dienste auf dem neuen Release neu aus, und das Gateway migriert die Datenbank beim Start. Zum Zurückrollen nutzen Sie **Rollback** bei jedem Dienst auf sein vorheriges Deployment. Migrationen laufen nur vorwärts, sodass ein Zurückrollen über ein Release hinweg, dessen Migrationen die frühere Version nicht ausführen kann, bleibt, wo es ist, wie auf jeder Installation.

## Was getestet wurde

Am 7. November 2026, während der Release-Kandidaten, wurde der Blueprint aus einem leeren Render-Projekt in Frankfurt angelegt. Er legte alle fünf Ressourcen an, die Einrichtungs-E-Mail kam an, Health- und Readiness-Prüfungen bestanden, und eine gestreamte Completion erreichte das Anfrageprotokoll der Konsole. Der Test fand außerdem, dass Render an `X-Forwarded-For` anhängt, was zur oben beschriebenen Änderung auf `CF-Connecting-IP` führte; diese Änderung besteht den lokalen Edge-Test und die Prüfung der Konfiguration, wurde aber noch nicht erneut live getestet.

## Nächste Schritte

- [Render in den Docs](https://docs.kaeso.app/de/self-hosting/platforms/render), mit jeder Einzelheit des Blueprints.
- [Backups und Hauptschlüssel](https://docs.kaeso.app/de/self-hosting/backups): Sichern Sie Render Postgres und bewahren Sie den Hauptschlüssel außerhalb von Render auf.
- [Wo Sie Kaeso betreiben](https://kaeso.app/de/articles/where-to-run-kaeso): wie sich Render mit den anderen Plattformen vergleicht.

Von Kaeso Team

## Weitere Artikel

- [Wo Sie Kaeso betreiben, vom eigenen Server bis zur verwalteten Cloud](https://kaeso.app/de/articles/where-to-run-kaeso.md): 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.
- [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.

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