Zum Inhalt springen

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
Ein blasser Verlauf aus Blau und Cyan, in senkrechten Falten wie ein Vorhang

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 bekommen

  • kaeso-edge
    Image
    Das Konsolen-Image, das kaeso-edge ausfü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

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 ausrollen

  1. Öffnen Sie Deploy on Railway (öffnet in einem neuen Tab) und melden Sie sich an.

  2. Tragen Sie bei kaeso-gateway diese Variablen ein:

    VariableWas 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 nutzt
    KAESO_CLICKHOUSE_URLEine ClickHouse-HTTP-URL mit Benutzer und Passwort für Anfrageprotokolle, oder leer

    Den Rest trägt die Vorlage ein: KAESO_MASTER_KEYS mit 32 zufälligen Bytes aus der Funktion secret() von Railway, und KAESO_PUBLIC_URL mit der Railway-Domain des Edge.

  3. Rollen Sie aus, und warten Sie, bis die fünf Dienste online sind.

  4. Öffnen Sie den einmaligen Einrichtungslink, den Ihnen das Gateway gesendet hat, und legen Sie den ersten Benutzer an.

  5. Kopieren Sie KAESO_MASTER_KEYS aus den Variablen von kaeso-gateway in 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 ausrollen

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 generate

Legen Sie dann ein leeres Projekt an:

railway loginrailway init

Fü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 apply

Geben 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 Domain

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ückrollen

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 wurde

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 Schritte

Von Kaeso Team

Auf dieser Seite

Ihr Gateway.Ihre Request-Logs.

curl -fsSLhttps://kaeso.app/install.sh | sh