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

# 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.

> 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

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

| 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 ausrollen

1. Öffnen Sie [Deploy on Railway](https://railway.com/deploy/cmVV60) und melden Sie sich an.
2. Tragen Sie bei `kaeso-gateway` diese Variablen ein:

   | Variable | Was einzutragen ist |
   | --- | --- |
   | `KAESO_SETUP_EMAIL` | Ihre Adresse; das Gateway sendet den Einrichtungslink dorthin |
   | `KAESO_SMTP_HOST`, `KAESO_SMTP_FROM` | Ihr SMTP-Server und der Absender der E-Mails von Kaeso |
   | `KAESO_SMTP_USER`, `KAESO_SMTP_PASSWORD` | Benutzername und Passwort des Servers, falls er sie braucht |
   | `KAESO_SMTP_PORT` | `587`, sofern Ihr Server keinen anderen Port nutzt |
   | `KAESO_CLICKHOUSE_URL` | Eine 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:

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

Legen Sie dann ein leeres Projekt an:

```bash
railway login
railway 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`](https://github.com/logicplanes/kaeso/blob/v0.6.0/.railway/railway.ts) des Releases in einen eigenen Ordner, installieren Sie das TypeScript-Paket von Railway und wenden Sie die Datei an:

```bash
npm install railway
railway 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

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

Von Kaeso Team

## Weitere Artikel

- [Kaeso auf Render ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-render.md): 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.
- [Kaeso auf DigitalOcean ausrollen](https://kaeso.app/de/articles/deploy-kaeso-on-digitalocean.md): Betreiben Sie Kaeso auf DigitalOcean App Platform mit dem Button Deploy to DigitalOcean, oder mit doctl und einem verwalteten Valkey für den Produktivbetrieb. Der eigene Edge der App leitet Konsole und APIs auf einer Domain.

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