Ever Lose Track of CPU, RAM, and Storage in Your Homelab?
If you take self-hosting seriously, reliability is everything. Beszel is an extremely lightweight, open-source server monitoring tool that fits perfectly into any modern homelab.
It consists of two main components:
-
The Hub: The central web interface (default port 8090) that aggregates all metrics clearly and stores historical data.
-
The Agent: A lightweight daemon running on each monitored system that transmits telemetry data back to the hub.
In addition to classic metrics like CPU, RAM, network, and disk usage, Beszel also keeps an eye on the health of individual Docker containers.
Pro Tip for Self-Hosting: Use a secure mesh VPN like Tailscale to transmit your monitoring data securely without exposing ports directly to the internet.
What is Beszel? The Lightweight Server Monitor for Your Homelab
Beszel is designed for users who want deep hardware visibility without the heavy resource footprint of traditional monitoring stacks like Prometheus or Grafana. It gives you a clean dashboard to track system health across all your bare-metal servers, VMs, and Raspberry Pis in real time.
Installing the Hub and Agent with Portainer
For this installation, we will use Docker Compose inside Portainer. Create a new stack with the following content:
services:
beszel:
image: henrygd/beszel:latest
container_name: beszel
restart: unless-stopped
environment:
APP_URL: <Your-IP>:8090
ports:
- 8090:8090
volumes:
- /data/beszel/beszel_data:/beszel_data
- /data/beszel/beszel_socket:/beszel_socket
beszel-agent:
image: henrygd/beszel-agent:latest
container_name: beszel-agent
restart: unless-stopped
network_mode: host
volumes:
- /data/beszel/agent_data:/var/lib/beszel-agent
- /data/beszel/beszel_socket:/beszel_socket
- /var/run/docker.sock:/var/run/docker.sock:ro
environment:
LISTEN: /beszel_socket/beszel.sock
HUB_URL: <Your-IP>:8090
TOKEN: ""
KEY: ""
Adjust APP_URL to match your local IP address and click Deploy the stack.
Creating the Admin Account and Linking Systems
-
Open
http://<Your-IP>:8090in your browser to create your administrator account. -
Click Add System to link your local Raspberry Pi or additional servers.
-
Copy the generated public key and token directly into your Portainer stack environment variables and update the stack. Within moments, your system status indicator will turn green!
FAQ
-
How do I connect additional servers to Beszel? Click Add System in the hub, select your preferred installation method (e.g., Docker Compose) for the target server, and run the generated command on that system.
-
How do I set up alerts for critical metrics? Configure an SMTP email service in the hub settings. Once set up, you can define custom threshold limits (e.g., 90% CPU utilization) to receive instant notifications during high-load events.
-
How do I back up my Beszel data? Since all historical metrics and settings are stored inside the Docker volume at
/data/beszel/beszel_data, a routine backup of this directory is all you need.





