Beszel-Agent
Beszel-agent is the lightweight, self-hosted monitoring client for the Beszel hub, reporting per-server CPU, memory, and network usage along with…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
85/100 Excellent
- Maintained
- 100last commit 21 days ago
- Popular
- 8926,731 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 10023 MB minimum RAM, runs on ARM
- Security check
- 88no serious findings, 2 minor, CI, tests
Availability: platform listings confirmed today, links checked 54 days ago
- GitHub stars
- 26,731
- Open issues
- 368
- Last commit
- 2026-10-30
- Latest release
- v0.21.1
- License
- MIT
- Activity
- declining
Checked 21 days ago - source: GitHub (henrygd/beszel)
Resources & Compatibility
Minimum requirements: 23 MB RAM. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Set your agent's Hub connection details Before starting the agent, have your Beszel Hub URL, token (a shared password-like code), and the public SSH key from your setup ready. If any are missing, the agent may start but won't connect to the Hub, so your machine won't appear in Beszel. source
- Use the official install script On Linux or FreeBSD, run the documented install script with sudo so it can install the latest agent and set up its service. This avoids missed setup steps and can configure automatic daily updates. source
- Start the agent automatically After the agent is installed, reload systemd (the Linux service manager), enable beszel-agent, and start it. This makes the agent run automatically after a reboot, so your monitoring doesn't stop. source
- No public exposure needed Agents connect directly to your Beszel hub, so no public internet exposure is required. source
Fetched 40 days ago - each note links to its source
Variants
Alternatives (12)
- Better Stack - AI-driven monitoring platform providing incident management, real-time logs, uptime, traces, error tracking, infrastructure analytics, and…
- Datadog - Datadog Agent is an on-host monitoring agent that collects metrics, logs, and traces from hosts, containers, and Kubernetes clusters and se…
- Grafana - Grafana is an open-source monitoring and observability platform for querying, visualizing, alerting on, and sharing dashboards for metrics…
- HetrixTools
- Icinga - Icinga is a fork of Nagios and is backward compatible.
- LibreNMS - LibreNMS is a fully featured network monitoring system that discovers and monitors network devices, interfaces, and services.
- Munin - Munin is a networked resource monitoring tool that can help analyze resource trends and "what just happened to kill our performance?&q…
- NIXStats
- Nagios - Nagios is an open-source monitoring system that checks hosts, network services, and IT infrastructure resources so IT administrators can id…
- Netdata - Netdata is a real-time performance and health monitoring solution that collects per-second metrics from your servers, containers, networks,…
- Tianji - Tianji is a self-hosted website analytics and uptime monitoring platform that combines visitor traffic insights, service availability check…
- Zabbix - Zabbix is an enterprise-class, open-source distributed monitoring solution designed to monitor the performance and availability of network…
Checked 51 days ago - source: AlternativeTo
Common questions
Why does my Beszel agent start but not show up in the hub?
If the Hub URL, token, or public SSH key are missing, the agent may start but will not connect to the Hub. As a result, the machine will not appear in Beszel.
What Docker network setting does the Beszel agent need?
The agent must use host network mode to access the host's network interface stats. This also exposes the agent port automatically, so the port can be changed with an environment variable.
Can I install the Beszel agent on a TrueNAS host?
A TrueNAS user found host installation blocked because the agent binary appears to expect files in read-only /opt. The thread is asking for best practices rather than confirming a working method.
Why run the Windows Beszel agent natively instead of in Docker?
The native Windows agent can report more accurate host stats than the Docker agent. In the thread, the user cited full RAM reporting, network bandwidth, CPU usage, and Nvidia GPU stats.
Answers sourced from beszel.dev, forums.truenas.com, github.com, www.beszel.dev
Community
- Beszel-agent install script - Hope it helps - forum.opnsense.org (forum)
- Beszel Agent Binary - TrueNAS General - TrueNAS Community Forums (forum)
- Is anyone else using Beszel agent on their OpenWrt setup? (forum)
Collected 48 days ago - public community threads