# 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 Docker/Podman container statistics to a central dashboard for historical. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/419/beszel-agent

## Description

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.

## Health score

85/100 (Excellent), based on 5 of 5 factors.
- Maintained: 100 (last commit 21 days ago)
- Popular: 89 (26,731 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 100 (23 MB minimum RAM, runs on ARM)
- Security check: 88 (no serious findings, 2 minor, CI, tests)

## Links

- GitHub: https://github.com/henrygd/beszel
- Official website: https://beszel.dev
- Docker Hub: https://hub.docker.com/r/henrygd/beszel-agent
- Unraid: https://ca.unraid.net/apps/beszel-agent-15ke9rk0c111ho?q=beszel-agent

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

## Alternatives

- 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 &quot;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…

---
Source: Our Local Host (https://ourlocalhost.com/app/419/beszel-agent), the self-hosted and open-source app directory.
