Deploy and Host Minecraft Bedrock Server on Railway

Minecraft Bedrock Server is the official dedicated server for Minecraft's cross-platform edition, letting mobile, console, and Windows players join the same world over UDP.

About Hosting Minecraft Bedrock Server

Runs via the itzg/minecraft-bedrock-server Docker image. Since Railway only proxies TCP publicly, a playit.gg agent tunnels UDP traffic to the server so players can connect

Common Use Cases

• Private worlds for friends/family across devices
• Small public/semi-private servers behind CGNAT
• Temporary or test Bedrock servers

Dependencies for Minecraft Bedrock Server Hosting

• Docker image: itzg/minecraft-bedrock-server
• playit.gg agent (Docker-based)
• Persistent volume at /data
• EULA=TRUE environment variable
• playit.gg account with a Minecraft Bedrock tunnel

Deployment Dependencies

• itzg Bedrock Docker image: https://github.com/itzg/docker-minecraft-bedrock-server
• playit.gg Docker setup wizard: https://playit.gg/account/setup/wizard/new-account
• playit.gg support docs: https://playit.gg/support/

Implementation Details

1. Deploy the Bedrock server service Add a service using the itzg/minecraft-bedrock-server image with EULA=TRUE set and a volume mounted at /data.

2. Deploy the playit.gg agent service Add a second service to the project for the playit agent:

1. Create a playit.gg account.
2. Go to the Docker setup wizard (https://playit.gg/account/setup/wizard/new-account) and select Docker.
3. Set an agent name and click Create.
4. Copy the SECRET_KEY value shown in the example and paste it as an environment variable on the playit agent service in Railway.

3. Create the tunnel Once the agent shows as connected:

1. Go to Tunnels > Create Tunnel.
2. Give the tunnel a name.
3. Set Tunnel Type to Minecraft Bedrock.
4. Set Public Network to Free Network.
5. Assign it to the agent created in step 2.
6. Under Origin Config, set the local address to the Bedrock service's internal Railway URL (e.g. bedrock.railway.internal).
7. Click Create Tunnel.

4. Connect and play Copy the tunnel's public address and port from the Tunnels page, enter it as a server in the Minecraft Bedrock client, and start playing.

Why Deploy Minecraft Bedrock Server 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 Minecraft Bedrock Server 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.