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.
- Veröffentlicht
- 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 bekommen01
kaeso-edge- Typ
- Web Service
- Image
- Das Konsolen-Image, das
kaeso-edgeausführt - Plan
- 0,5 CPU, 512 MB
kaeso-gateway- Typ
- Private Service
- Image
- Das Gateway-Image
- Plan
- 2 CPU, 4 GB
kaeso-console- Typ
- Private Service
- Image
- Das Konsolen-Image
- Plan
- 0,5 CPU, 512 MB
kaeso-valkey- Typ
- Key Value
- Image
- Das von Render, mit
noeviction - Plan
- 256 MB
kaeso-postgres- Typ
- Postgres
- Image
- Das von Render, Version 18
- Plan
- 1 CPU, 2 GB
| 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 beginnen02
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:
docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generateBewahren 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.
Ausrollen03
- 01
Öffnen Sie Deploy to Render (öffnet in einem neuen Tab). Es legt einen Blueprint aus dem Repository
logicplanes/kaesoauf dem Branchprodan, der das neueste Release enthält. - 02
Tragen Sie die Werte ein, die der Blueprint abfragt:
Wert Was einzutragen ist KAESO_PUBLIC_URLhttps://und die Adresse des Edge, etwahttps://kaeso-edge.onrender.comKAESO_MASTER_KEYSDer Hauptschlüssel KAESO_SETUP_EMAILIhre Adresse; das Gateway sendet den Einrichtungslink dorthin KAESO_SMTP_HOST,KAESO_SMTP_USER,KAESO_SMTP_PASSWORD,KAESO_SMTP_FROMIhr SMTP-Server KAESO_CLICKHOUSE_URLEine ClickHouse-HTTP-URL mit Benutzer und Passwort, oder leer - 03
Wenden Sie den Blueprint an, und warten Sie, bis jeder Dienst läuft.
- 04
Öffnen Sie den einmaligen Einrichtungslink, den das Gateway an
KAESO_SETUP_EMAILgesendet 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 Domain04
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 bleiben05
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ückrollen06
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 wurde07
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 Schritte08
- Render in den Docs (öffnet in einem neuen Tab), mit jeder Einzelheit des Blueprints.
- Backups und Hauptschlüssel (öffnet in einem neuen Tab): Sichern Sie Render Postgres und bewahren Sie den Hauptschlüssel außerhalb von Render auf.
- Wo Sie Kaeso betreiben: wie sich Render mit den anderen Plattformen vergleicht.
Von Kaeso Team


