Beszel
A lightweight server monitor with historical host metrics, Docker statistics, alerts, and a hub-agent architecture.
Why consider Beszel?
Beszel is a lightweight server monitoring platform featuring historical performance metrics, Docker statistics, and configurable alerting. It provides system administrators and homelab users with a responsive PocketBase web dashboard and minimal agent footprint.
Learn Beszel by building
Practical setup notes, real use cases, and copy-ready examples in one focused guide.
In this guide4 sections
Lightweight Server Monitoring with Beszel
As modern infrastructure expands across diverse virtual machines, physical hardware, and containerized clusters, system operators require responsive visibility into resource consumption without imposing heavy daemon overhead on monitored hosts. According to its official documentation, Beszel is a lightweight server monitoring platform that includes Docker statistics, historical data, and alert functions. It delivers real-time telemetry alongside long-term metric retention within an efficient architecture.
The platform separates monitoring responsibilities into two distinct software layers to minimize compute overhead on target nodes. As detailed in the project repository, the hub is a web application built on PocketBase that provides a dashboard for viewing and managing connected systems. In coordination with the hub, the agent runs on each system you want to monitor and communicates system metrics to the hub.
System Metrics and Configurable Alerting
Infrastructure reliability depends on detecting resource saturation before services experience degraded throughput or complete outages. As outlined in the README, it provides configurable alerts for CPU, memory, disk, bandwidth, temperature, fan speed, load average, and status. Administrators can set fine-grained thresholds to receive notifications across channels like Telegram, Discord, Gotify, or generic webhooks when hardware components approach capacity limits.
Beyond standard host operating system telemetry, the platform integrates deep visibility into containerized workflows. As highlighted on the official website, it tracks CPU, memory, and network usage history for each container. This historical tracking helps operators pinpoint misbehaving microservices or memory leaks across Docker and Podman instances without deploying heavy third-party collection agents.
Multi-User Administration and Secure Access
Team collaboration requires flexible access boundaries so that engineers can observe relevant infrastructure without exposing unrelated systems. According to the official documentation, Beszel includes multi-user support where users manage their own systems and admins can share systems across users. This delegation simplifies access control across engineering departments and multi-tenant homelab setups.
Identity management is designed to integrate cleanly with modern authentication protocols. As documented in the project repository, for authentication, it supports many OAuth2 providers and password auth can be disabled. Disabling standard password authentication in favor of corporate OAuth2 or OpenID Connect providers strengthens access controls and aligns with enterprise security practices.
To prevent telemetry loss during server migrations or disk failures, the platform includes built-in snapshot mechanisms. As noted in the documentation, automated backups allow administrators to save to and restore from disk or S3-compatible storage. This capability guarantees that historical telemetry and configuration states remain resilient against unexpected storage failures.
Deploying the Beszel Hub with Docker
Deploying the central hub service is straightforward using container orchestration. According to the hub installation guide, all deployment methods will start the Beszel service on port 8090 and mount the ./beszel_data directory for persistent storage. You can declare the service inside a docker-compose.yml file using the official configuration:
services: beszel: image: "henrygd/beszel" container_name: "beszel" restart: unless-stopped ports: - "8090:8090" volumes: - ./beszel_data:/beszel_datadocker compose up -dAccording to the getting started guide, after starting the container, navigate to port 8090 in your browser to configure the initial administrator user account. From the dashboard, you can register client systems, retrieve agent connection tokens, and configure notification rules.
License and Open-Source Ecosystem
Beszel is distributed as free, open-source software. Under its official license, Beszel is licensed under the permissive terms of the MIT License. This permissive licensing grants developers and enterprises the flexibility to integrate, modify, and host the monitoring tool in commercial and private environments without restrictive obligations.
With active ongoing maintenance on its canonical GitHub repository, Beszel offers a compelling balance of minimal resource consumption and actionable system insights. It has a friendly web interface, simple configuration, and is ready to use out of the box.
Related tools
More options with a similar category or technology profile.
dash.
Simple, modern server dashboard and hardware monitor for homelabs.
Xen Orchestra
Complete web-based management and backup solution for XCP-ng and XenServer.
Cockpit Project
Web-based graphical interface for Linux servers with zero overhead.
Kresus
Self-hosted personal finance manager with automatic bank synchronization.