---
title: "Deploy Beszel"
description: "Beszel 0.20 lightweight server and Docker monitoring hub with alerts."
category: "Observability"
url: https://railway.com/deploy/beszel-1
---

# Deploy Beszel

Beszel 0.20 lightweight server and Docker monitoring hub with alerts.

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

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

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

## Template content

### beszel https://raw.githubusercontent.com/henrygd/beszel/v0.20.0/internal/site/public/static/icon.png

- **Image:** henrygd/beszel:0.20.0
- **Start command:** `/beszel serve --http=[::]:8090`
- **Health check:** /api/health
- **Public domain:** Yes

## Documentation

# 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

- [Beszel documentation](https://beszel.dev/guide/getting-started)
- [Beszel v0.20.0 release](https://github.com/henrygd/beszel/releases/tag/v0.20.0)
- [Agent installation](https://beszel.dev/guide/agent-installation)
- [Railway volumes](https://docs.railway.com/reference/volumes)

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

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


## Similar templates

- [Rootprint](https://railway.com/deploy/rootprint-1) — Open-source logs and traces with full-text search on object-storage.
- [Pyroscope profiling](https://railway.com/deploy/pyroscope-profiling) — Protected continuous profiling with durable Pyroscope storage.
- [SigOnly](https://railway.com/deploy/sigonly) — Deploy SigNoz with a working demo app & config in one click

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