Skip to content

docs(self-hosting): note the Railway ENCRYPTION_KEY must be 64-char hex #6530

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
eeshsaxena wants to merge 2 commits into
base: main
Choose a base branch
from
+5 −1
Open

docs(self-hosting): note the Railway ENCRYPTION_KEY must be 64-char hex #6530

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a6fb74f
docs(self-hosting): note the Railway ENCRYPTION_KEY must be 64-char hex
eeshsaxena Aug 7, 2026
415e9b2
docs(self-hosting): normalize line endings to LF and drop stray trail…
eeshsaxena Aug 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion apps/docs/content/docs/en/platform/self-hosting/platforms.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,10 @@ After deployment, set in the Railway dashboard:
- An AI provider key such as `OPENAI_API_KEY`
- Your custom domain under **Settings → Networking**, then `NEXT_PUBLIC_APP_URL` to match

<Callout type="warn">
The template auto-generates `ENCRYPTION_KEY` as a URL-safe secret, but Sim requires a 64-character hex string. If saving Workspace Secrets fails with `ENCRYPTION_KEY must be set to a 64-character hex string` (HTTP 500), regenerate it with `openssl rand -hex 32` and update the variable in the Railway dashboard.
</Callout>

<Callout type="warn">
The Railway template deploys the app services but not the `cron` service, so scheduled workflows and polling triggers stay idle. Add a Railway cron service calling the endpoints in [Background Jobs](/platform/self-hosting/background-jobs), or deploy with Docker Compose instead.
</Callout>
Expand Down Expand Up @@ -49,4 +53,4 @@ Recommended for any production deployment. The requirement is **pgvector**.
DATABASE_URL="postgresql://user:pass@host:5432/simstudio?sslmode=require"
```

For the Helm chart, disable the bundled Postgres and use `externalDatabase` — see [Kubernetes](/platform/self-hosting/kubernetes#external-database).
For the Helm chart, disable the bundled Postgres and use `externalDatabase` — see [Kubernetes](/platform/self-hosting/kubernetes#external-database).