Deploy and Host Portunus Server on Railway

Portunus is a Rust control-plane server for managing port-based TCP and UDP forwarding. This template deploys the server with its embedded Web UI, operator HTTP API, persistent SQLite state, and a TCP proxy endpoint for client gRPC connections.

About Hosting Portunus Server

The template builds Portunus from the GitHub repository using the Railway Dockerfile. Railway exposes the Web UI over HTTP on port 7080 and the control-plane gRPC listener over a TCP proxy on port 7443. A mounted volume at /var/lib/portunus stores the SQLite database, generated TLS material, config, and server state.

After deployment, set PORTUNUS_ADVERTISED_ENDPOINT to the Railway TCP Proxy host:port shown for the service. This value is required so provisioned client bundles connect to the public gRPC endpoint instead of localhost.

Common Use Cases

• Self-host a lightweight forwarding control plane.
• Manage TCP and UDP forwarding clients from a Web UI.
• Keep Portunus state persistent across Railway deploys.

Dependencies for Portunus Server Hosting

• A Railway service built from ZingerLittleBee/Portunus.
• A Railway volume mounted at /var/lib/portunus.
• Railway HTTP networking on port 7080.
• Railway TCP Proxy on application port 7443.

Deployment Dependencies

• Source: https://github.com/ZingerLittleBee/Portunus
• Railway deployment docs: https://docs.railway.com

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