Deploy and Host Tolgee on Railway

Tolgee is an open-source localization platform for web and mobile apps. Developers push translation keys through its REST API, CLI or SDKs, and translators edit them in a web editor with machine translation suggestions. Its in-context mode lets you change text right inside your running app, and it exports to common file formats.

About Hosting Tolgee

This template runs the official tolgee/tolgee:v3.224.8 image with a Railway Postgres database. The image's built-in Postgres is switched off, since Tolgee 4 removes it anyway. On first boot, Tolgee creates an admin user with a generated password, and sign-up is closed, so only people you invite can join. Uploaded screenshots and import files are kept on a Railway volume. Railway blocks outgoing SMTP, so invitation and password-reset emails need an SMTP relay that works on Railway, or you share invite links yourself. The Java server takes about a minute to start.

Common Use Cases

Managing app translations with developers and translators in one place
Fetching translations at runtime or in CI through project API keys
In-context editing of text in a React, Vue, Angular or mobile app

Dependencies for Tolgee Hosting

tolgee/tolgee:v3.224.8 (official image)
Railway Postgres and a volume at /data

Deployment Dependencies

Implementation Details

Service	Source	Networking	Storage
tolgee	`tolgee/tolgee:v3.224.8`	public HTTPS	Postgres + volume at `/data`
Postgres	Railway Postgres	private	volume

Variable	Default	Purpose
`TOLGEE_AUTHENTICATION_INITIAL_USERNAME`	`admin`	First administrator
`TOLGEE_AUTHENTICATION_INITIAL_PASSWORD`	generated	Its password (used on first boot only)
`TOLGEE_AUTHENTICATION_REGISTRATIONS_ALLOWED`	`false`	Open sign-up
`TOLGEE_FRONT_END_URL`	public URL	Used in links and emails
`TOLGEE_TELEMETRY_ENABLED`	`false`	Usage telemetry

Fetch translations with a project API key:

curl -H "X-API-Key: $TOLGEE_API_KEY" "https:///v2/projects/translations/en,de"

Machine translation providers (Google, DeepL, AWS) and SMTP are configured with more TOLGEE_* variables; see the configuration reference.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by Tolgee.

Why Deploy Tolgee on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Tolgee on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.