Kaeso auf Railway ausrollen
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.
- Veröffentlicht
- Lesezeit
- 3 Min.
- Autor
- Kaeso Team

Railway ist der schnellste Weg, Kaeso auf einer Plattform auszuprobieren: Der Button Deploy on Railway legt das ganze Projekt an, erzeugt den Hauptschlüssel und trägt die öffentliche Adresse ein. Sie geben Ihre E-Mail-Adresse und einen SMTP-Server ein und warten, bis fünf Dienste online sind.
Für Teams, die ihre Infrastruktur als Code halten, hat das Repository außerdem .railway/railway.ts, dasselbe Projekt im TypeScript-Format von Railway, für die Railway-CLI.
Was Sie bekommen01
kaeso-edge- Image
- Das Konsolen-Image, das
kaeso-edgeausführt - Erreicht von
- Allen, auf seiner Railway-Domain oder Ihrer eigenen
kaeso-gateway- Image
- Das Gateway-Image
- Erreicht von
- Dem Edge, im privaten Netz von Railway
kaeso-console- Image
- Das Konsolen-Image
- Erreicht von
- Dem Edge, im privaten Netz von Railway
kaeso-postgres- Image
- Railway Postgres
- Erreicht von
- Dem Gateway
kaeso-valkey- Image
- Railway Redis
- Erreicht von
- Dem Gateway
| Dienst | Image | Erreicht von |
|---|---|---|
kaeso-edge | Das Konsolen-Image, das kaeso-edge ausführt | Allen, auf seiner Railway-Domain oder Ihrer eigenen |
kaeso-gateway | Das Gateway-Image | Dem Edge, im privaten Netz von Railway |
kaeso-console | Das Konsolen-Image | Dem Edge, im privaten Netz von Railway |
kaeso-postgres | Railway Postgres | Dem Gateway |
kaeso-valkey | Railway Redis | Dem Gateway |
Das private Netz von Railway ist nur IPv6, also lauscht das Gateway auf [::]:8080 und vertraut dem Edge aus dem Bereich der Unique Local Addresses. Jeder Dienst setzt PORT auf den Port, auf dem er lauscht und den die Health-Checks von Railway aufrufen. Automatische Image-Updates sind aus, sodass die Dienste auf dem Release bleiben, mit dem sie ausgerollt wurden.
Mit dem Button ausrollen02
- 01
Öffnen Sie Deploy on Railway (öffnet in einem neuen Tab) und melden Sie sich an.
- 02
Tragen Sie bei
kaeso-gatewaydiese Variablen ein:Variable Was einzutragen ist KAESO_SETUP_EMAILIhre Adresse; das Gateway sendet den Einrichtungslink dorthin KAESO_SMTP_HOST,KAESO_SMTP_FROMIhr SMTP-Server und der Absender der E-Mails von Kaeso KAESO_SMTP_USER,KAESO_SMTP_PASSWORDBenutzername und Passwort des Servers, falls er sie braucht KAESO_SMTP_PORT587, sofern Ihr Server keinen anderen Port nutztKAESO_CLICKHOUSE_URLEine ClickHouse-HTTP-URL mit Benutzer und Passwort für Anfrageprotokolle, oder leer Den Rest trägt die Vorlage ein:
KAESO_MASTER_KEYSmit 32 zufälligen Bytes aus der Funktionsecret()von Railway, undKAESO_PUBLIC_URLmit der Railway-Domain des Edge. - 03
Rollen Sie aus, und warten Sie, bis die fünf Dienste online sind.
- 04
Öffnen Sie den einmaligen Einrichtungslink, den Ihnen das Gateway gesendet hat, und legen Sie den ersten Benutzer an.
- 05
Kopieren Sie
KAESO_MASTER_KEYSaus den Variablen vonkaeso-gatewayin einen Passwort-Manager. Kaeso verschlüsselt Anbieter-Schlüssel damit, sodass sich ein Datenbank-Backup ohne ihn nicht lesen lässt.
Das Gateway startet nicht ohne SMTP-Server, und sein Image hat keine Shell, also kann railway ssh keinen Einrichtungslink ausgeben. Kommt die E-Mail nicht an, nennen die Protokolle des Gateways den SMTP-Fehler. Korrigieren Sie die Variablen und rollen Sie das Gateway neu aus: Es sendet bei jedem Start einen neuen Link, solange kein Benutzer existiert.
Mit der CLI ausrollen03
Erzeugen Sie zuerst einen Hauptschlüssel, und bewahren Sie ihn in einem Passwort-Manager auf:
docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generateLegen Sie dann ein leeres Projekt an:
railway loginrailway initFügen Sie in den Settings des Projekts unter Shared Variables KAESO_PUBLIC_URL (vorerst ein Platzhalter), KAESO_MASTER_KEYS, KAESO_SETUP_EMAIL, die Werte KAESO_SMTP_* Ihres SMTP-Servers und, für Anfrageprotokolle, KAESO_CLICKHOUSE_URL hinzu.
Legen Sie .railway/railway.ts (öffnet in einem neuen Tab) des Releases in einen eigenen Ordner, installieren Sie das TypeScript-Paket von Railway und wenden Sie die Datei an:
npm install railwayrailway config applyGeben Sie kaeso-edge unter seinen Settings eine Domain für Port 8080. Setzen Sie KAESO_PUBLIC_URL auf https:// und diese Domain, und rollen Sie kaeso-gateway neu aus; der Einrichtungslink kommt per E-Mail.
Railway kennzeichnet Infrastruktur als Code als experimentell, ihre API kann sich also noch ändern. Die älteren railway.json und railway.toml von Railway funktionieren ab dem 1. Dezember 2026 nicht mehr, weshalb das Repository keine von beiden hat.
Ihre eigene Domain04
Fügen Sie die Domain bei kaeso-edge unter Settings hinzu, setzen Sie KAESO_PUBLIC_URL bei kaeso-gateway auf https:// und diese Domain, und rollen Sie das Gateway neu aus.
Aktualisieren und zurückrollen05
Bei einem Projekt aus dem Button ändern Sie das Image-Tag von kaeso-gateway, kaeso-console und kaeso-edge in den Settings jedes Dienstes auf das neue Release, das Gateway zuerst. Bei einem Projekt aus der Datei wenden Sie die railway.ts des neuen Releases an, und Railway rollt neu aus, was sich geändert hat. Das Gateway migriert die Datenbank beim Start, nur vorwärts. Zum Zurückrollen rollen Sie ein früheres Deployment aus der Liste Deployments eines Dienstes neu aus.
Was getestet wurde06
Am 9. November 2026 wurde die Datei auf ein leeres Railway-Projekt angewendet und die Vorlage in ein anderes ausgerollt, beide mit dem achten Release-Kandidaten. In beiden kamen die fünf Dienste online, der Edge lieferte Konsole und APIs auf der Railway-Domain aus, und der erste Benutzer wurde angelegt und angemeldet. Dieser Lauf fand das fehlende PORT, das die Datei und die Vorlage jetzt setzen. E-Mail-Zustellung, eine gestreamte Antwort und ein Update wurden auf Railway noch nicht getestet.
Nächste Schritte07
- Railway in den Docs (öffnet in einem neuen Tab), mit jeder Variable.
- Backups und Hauptschlüssel (öffnet in einem neuen Tab): Sichern Sie Railway Postgres und bewahren Sie den Hauptschlüssel außerhalb von Railway auf.
- Wo Sie Kaeso betreiben: wie sich Railway mit den anderen Plattformen vergleicht.
Von Kaeso Team


