Skip to main content
Beszel is a lightweight server-monitoring tool with historical data and alerts. It is an alternative to the default Netdata — ideal for low-resource nodes (e.g. a Raspberry Pi) where a full metrics agent is too heavy. Beszel is served at monitor.<domain>.

​
Enable Beszel

stack-spec.yaml
stackkit: base-kit
mode: pi          # low-resource intent favors lightweight tools

services:
  beszel:
    enabled: true
On mode: pi and low compute tiers the resolver already prefers lightweight metrics. Beszel and Netdata cover the same need — pick one. See tool alternatives.

​
Steps

1

Open Beszel

Open https://monitor.<domain> and create the first admin user.
2

Add agents

Register each node’s Beszel agent so its metrics report to the hub.
3

Configure alerts

Set CPU, memory, and disk thresholds with a notification channel you watch.

​
Verify

  • The Beszel hub is reachable at monitor.<domain>.
  • Each node reports CPU, RAM, disk, and network history.

​
Next steps

Netdata

The richer default metrics agent for larger nodes.

Tool alternatives

Compare the monitoring options.

​
Troubleshooting

Confirm the node’s Beszel agent is running and can reach the hub on monitor.<domain>; check docker logs beszel.