Deploy and Host Tuwunel on Railway

Tuwunel is a fast Matrix homeserver written in Rust and the successor to conduwuit. Matrix is an open, federated chat protocol: you can talk to people on matrix.org and other servers, run bridges and bots, and use clients such as Element, Cinny or FluffyChat on every platform.

About Hosting Tuwunel

This template runs the official jevolk/tuwunel:v1.9.2 image as one service with its RocksDB database on a Railway volume. Tuwunel serves the .well-known files itself, so federation works on the Railway domain over port 443; the public Matrix federation tester reports it as OK. Registration requires the generated token, and the first account registered becomes the server admin. The database worker pool is capped so Tuwunel stays within Railway's process limits. Your server name is the Railway domain; set TUWUNEL_SERVER_NAME to a custom domain before the first boot if you want addresses like @you:example.com. It needs around 200 MB of memory.

Common Use Cases

A private Matrix server for family, friends or a team
A home for Matrix bots and bridges to other chat networks
Federated chat with people on matrix.org and other servers

Dependencies for Tuwunel Hosting

jevolk/tuwunel:v1.9.2 (official image)
A Railway volume at /var/lib/tuwunel for RocksDB

Deployment Dependencies

Implementation Details

Service	Source	Networking	Storage
tuwunel	`jevolk/tuwunel:v1.9.2`	public domain on 8008	volume at `/var/lib/tuwunel`

Variable	Default	Purpose
`TUWUNEL_SERVER_NAME`	`${{RAILWAY_PUBLIC_DOMAIN}}`	Server name in user IDs (never change later)
`TUWUNEL_REGISTRATION_TOKEN`	generated	Token needed to register
`TUWUNEL_WELL_KNOWN__CLIENT` / `__SERVER`	Railway domain	Discovery and federation on port 443
`TUWUNEL_DB_POOL_MAX_WORKERS`	`64`	Keeps threads within Railway's limits
`TUWUNEL_IP_SOURCE`	`rightmost_x_forwarded_for`	Real client IPs behind Railway's proxy

Notes:

Register the first account in Element with the homeserver URL and the token; it becomes admin.
Remove TUWUNEL_ALLOW_REGISTRATION or rotate the token once everyone has joined.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by the Tuwunel project or matrix-construct.

Why Deploy Tuwunel 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 Tuwunel 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.