---
title: "Deploy Tolgee"
description: "Tolgee 3.224: localization platform with REST API, SDKs and in-context UI."
category: "Other"
url: https://railway.com/deploy/tolgee-1
---

# Deploy Tolgee

Tolgee 3.224: localization platform with REST API, SDKs and in-context UI.

**[Deploy Tolgee on Railway](https://railway.com/template/tolgee-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/tolgee-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

### tolgee https://github.com/tolgee.png

- **Image:** tolgee/tolgee:v3.224.8
- **Health check:** /actuator/health
- **Public domain:** Yes

## Documentation

# 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

- [Tolgee self-hosting](https://docs.tolgee.io/platform/self_hosting/getting_started)
- [Tolgee v3.224.8 release](https://github.com/tolgee/tolgee-platform/releases/tag/v3.224.8)
- [Tolgee JS SDK](https://docs.tolgee.io/js-sdk)

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

```bash
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.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/tolgee-1