beszel-agent

beszel-agent

Docker app from LubricantJam's Repository

Overview

Agent for Beszel -- a lightweight server monitoring hub.

Beszel

Beszel is a lightweight server monitoring platform that includes Docker statistics, historical data, and alert functions.

It has a friendly web interface, simple configuration, and is ready to use out of the box. It supports automatic backup, multi-user, OAuth authentication, and API access.

agent Docker Image Size hub Docker Image Size MIT license Crowdin

Screenshot of Beszel dashboard and system page, side by side. The dashboard shows metrics from multiple connected systems, while the system page shows detailed metrics for a single system.

Features

  • Lightweight: Smaller and less resource-intensive than leading solutions.
  • Simple: Easy setup with little manual configuration required.
  • Docker stats: Tracks CPU, memory, and network usage history for each container.
  • Alerts: Configurable alerts for CPU, memory, disk, bandwidth, temperature, load average, and status.
  • Multi-user: Users manage their own systems. Admins can share systems across users.
  • OAuth / OIDC: Supports many OAuth2 providers. Password auth can be disabled.
  • Automatic backups: Save to and restore from disk or S3-compatible storage.

Architecture

Beszel consists of two main components: the hub and the agent.

  • Hub: A web application built on PocketBase that provides a dashboard for viewing and managing connected systems.
  • Agent: Runs on each system you want to monitor and communicates system metrics to the hub.

Getting started

The quick start guide and other documentation is available on our website, beszel.dev. You'll be up and running in a few minutes.

Screenshots

Dashboard System page Notification Settings

Supported metrics

  • CPU usage - Host system and Docker / Podman containers.
  • Memory usage - Host system and containers. Includes swap and ZFS ARC.
  • Disk usage - Host system. Supports multiple partitions and devices.
  • Disk I/O - Host system. Supports multiple partitions and devices.
  • Network usage - Host system and containers.
  • Load average - Host system.
  • Temperature - Host system sensors.
  • GPU usage / power draw - Nvidia, AMD, and Intel.
  • Battery - Host system battery charge.
  • Containers - Status and metrics of all running Docker / Podman containers.
  • S.M.A.R.T. - Host system disk health (includes eMMC wear/EOL and Linux mdraid array health via sysfs when available).

Help and discussion

Please search existing issues and discussions before opening a new one. I try my best to respond, but may not always have time to do so.

Bug reports and feature requests

Bug reports and feature requests can be posted on GitHub issues.

Support and general discussion

Support requests and general discussion can be posted on GitHub discussions or the community-run Matrix room: #beszel:matrix.org.

License

Beszel is licensed under the MIT License. See the LICENSE file for more details.

Install beszel-agent on Unraid in a few clicks.

Find beszel-agent in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for beszel-agent Review the template variables and paths Click Install

Requirements

You will need to configure the beszel web panel along-side this container. This is a reporting agent only. This container must stay on the host network for reporting purposes.

Download Statistics

20,573,413
Total Downloads
2,244,885
This Month
1,853,243
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Details

Repository
henrygd/beszel-agent:latest
Last Updated2026-04-30
First Seen2024-07-25

Runtime arguments

Network
host
Shell
bash
Privileged
false

Template configuration

Listen PortVariable

The port which you have opened for the SSH port.

Target
PORT
Default
45876
Value
45876
SSH KeyVariable

Public SSH Key to use for authentication. Provided by the web panel.

Target
KEY
Value
ssh-ed25519 YOUR_PUBLIC_KEY
Root File SystemVariable

Filesystem/partition to use for disk I/O stats. Use 'df -h' to find one.

Target
FILESYSTEM
Value
/
File System #1Pathro

The path of the file system you wish to monitor. If you have multiple file systems you wish to monitor, duplicate this path mapping and rename accordingly.

Target
/extra-filesystems/cache
Value
/mnt/cache/.beszel
Docker SocketPathro
Target
/var/run/docker.sock
Default
/var/run/docker.sock
Value
/var/run/docker.sock