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…

  • Monitoring & Logging
  • Network Services
  • Tools & Utilities
Beszel-agent is the lightweight, self-hosted monitoring client for the Beszel hub, reporting per-server CPU, memory, and network usage along with Docker/Podman container statistics to a central dashboard for historical charts and alerts.

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

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

Collected 48 days ago - public community threads