Deploy and Host Beszel on Railway

Beszel is a lightweight server monitoring platform. A small agent on each machine reports CPU, memory, disk, network, temperatures, GPU and per-container Docker stats to a central hub, which keeps history, draws charts, shares dashboards with users and sends alerts through email, Slack, Discord, Telegram, ntfy and more.

About Hosting Beszel

This template deploys the Beszel hub v0.20.0 from the official image with its PocketBase database on a Railway volume. The first user and superuser are created from environment variables, and public sign-up stays off. Agents on your servers connect outbound to the hub over WebSocket on the Railway domain, so no inbound ports are needed on the monitored machines. Add a system in the web UI, or use the universal token, and run the agent command it shows. The hub is tiny and fits the Hobby plan. Monitored machines only make outbound connections to the hub, which suits servers behind NAT or firewalls.

Common Use Cases

Monitoring VPS, home-lab and bare-metal servers from one dashboard
Tracking Docker container resource usage across hosts
Alerts when CPU, memory, disk or temperature cross a threshold

Dependencies for Beszel Hosting

henrygd/beszel:0.20.0 (official hub image)
A Railway volume at /beszel_data
henrygd/beszel-agent on each monitored machine

Deployment Dependencies

Implementation Details

Service	Image	Networking	Storage
beszel	`henrygd/beszel:0.20.0`	public domain on 8090; private	volume at `/beszel_data`

Run an agent on a server with the key and token shown in the hub:

docker run -d --name beszel-agent --network host --restart unless-stopped \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -e HUB_URL=https:// -e TOKEN= -e KEY="" \
  henrygd/beszel-agent:0.20.0

Variable	Default	Purpose
`USER_EMAIL` / `USER_PASSWORD`	`admin@example.com` / generated	First user and superuser
`APP_URL`	`https://`	Used in agent install commands

Notes:

The start command binds the hub to [::]:8090 for both IPv4 and IPv6; keep it when editing the service.
The superuser admin panel is at /_/.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by the Beszel project or its maintainers.

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