ScriptsApr 16, 2026·3 min read

Beszel — Lightweight Self-Hosted Server Monitoring

Beszel is a lightweight server monitoring platform with historical data, Docker container stats, and configurable alerts. It uses a hub-agent architecture with minimal resource overhead and a clean, modern dashboard.

Script Depot
Script Depot · Community
TL;DR
Beszel monitors servers with Docker stats, alerts, and a clean dashboard using minimal resources.
§01

What it is

Beszel is a lightweight self-hosted server monitoring platform. It uses a hub-agent architecture where a central hub collects data from lightweight agents running on your servers. It provides historical data graphs, Docker container statistics, configurable alerts, and a clean modern dashboard, all with minimal resource overhead.

Beszel targets homelab operators, small teams, and developers who want server monitoring without the complexity and resource consumption of Prometheus plus Grafana stacks. The agent binary uses minimal CPU and memory, making it suitable for low-powered devices.

§02

Why it saves time or tokens

Setting up Prometheus, Grafana, and alerting rules requires significant configuration effort. Beszel provides monitoring, visualization, and alerts in a single deployable unit. The hub-agent model means adding a new server is one command on the target machine. For teams using AI assistants to manage infrastructure, Beszel's simple configuration reduces the prompt complexity needed to set up monitoring.

§03

How to use

  1. Deploy the Beszel hub using Docker or the binary on your monitoring server
  2. Install the Beszel agent on each server you want to monitor
  3. Connect agents to the hub and configure alerts in the web dashboard
§04

Example

# docker-compose.yml for Beszel hub
version: '3'
services:
  beszel:
    image: henrygd/beszel:latest
    ports:
      - '8090:8090'
    volumes:
      - ./data:/beszel/data
    restart: unless-stopped

On each monitored server, run the agent:

curl -sL https://get.beszel.dev | bash
FeatureDescription
CPU/Memory/DiskReal-time and historical graphs
Docker statsPer-container CPU, memory, network
AlertsConfigurable thresholds and notifications
DashboardClean web UI with dark mode
Agent footprintMinimal CPU and memory usage
§05

Related on TokRepo

§06

Common pitfalls

  • The agent needs network access to the hub; ensure firewall rules allow the connection on the configured port
  • Historical data storage grows over time; configure data retention policies to prevent disk exhaustion on the hub server
  • Beszel is designed for server metrics, not application-level observability; use it alongside APM tools for full-stack monitoring

Frequently Asked Questions

How does Beszel compare to Prometheus and Grafana?+

Prometheus plus Grafana is a powerful, scalable monitoring stack that requires significant setup and resources. Beszel is a single application that provides monitoring, visualization, and alerts with minimal configuration. Choose Beszel for simplicity on small deployments; choose Prometheus for large-scale, highly customizable observability.

What resources does the Beszel agent consume?+

The Beszel agent is designed for minimal overhead. It typically uses less than 10MB of memory and negligible CPU. This makes it suitable for low-powered devices like Raspberry Pi servers or small VPS instances where a full Prometheus node exporter would be too heavy.

Does Beszel support Docker container monitoring?+

Yes. Beszel automatically detects Docker containers on monitored servers and reports per-container CPU usage, memory consumption, and network traffic. The agent connects to the Docker socket to collect this information without additional configuration.

Can Beszel send alerts to Slack or email?+

Yes. Beszel supports configurable alert notifications. You set thresholds for CPU, memory, disk, or other metrics, and Beszel sends notifications when those thresholds are crossed. Check the documentation for the specific notification channels supported in your version.

Is Beszel suitable for production environments?+

Beszel works well for small to medium production environments where simplicity is valued over scalability. For large-scale deployments with hundreds of servers, a dedicated monitoring stack like Prometheus provides better horizontal scaling and query capabilities.

Citations (3)
Related on TokRepo
Monitoring toolsSelf-hosted toolsFeatured workflows

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

Moodle — Open-Source Learning Management System

The most widely used open-source learning platform, providing course management, assessments, and collaboration tools for educators and organizations worldwide.

Script Depot

Sylius — Headless E-Commerce Framework on Symfony

An open-source headless e-commerce platform built on Symfony and API Platform, designed for developers who need a customizable and API-first commerce solution.

Script Depot

Akaunting — Free Self-Hosted Accounting Software

A free, open-source online accounting application built on Laravel for small businesses and freelancers to manage invoices, expenses, and financial reports.

Script Depot
◈Home🔍Search👤Me