explaingit

henrygd/beszel

Analysis updated 2026-06-21

21,644GoAudience · ops devopsComplexity · 2/5LicenseSetup · easy

TLDR

Beszel is a lightweight self-hosted server monitor with a web dashboard showing CPU, memory, disk, and Docker container metrics in real time, with configurable alerts and backup support.

Mindmap

mindmap
  root((Beszel))
    What it does
      Server monitoring
      Web dashboard
      Docker tracking
    Metrics Tracked
      CPU and memory
      Disk and network
      Temperature
    Features
      Configurable alerts
      Multi-user support
      Data backups
    Deployment
      Hub and agent
      Self-hosted
      S3 backup support
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Monitor CPU, memory, disk, and network usage across multiple servers from a single web dashboard.

USE CASE 2

Track individual Docker container resource usage alongside the host system metrics.

USE CASE 3

Set up alerts to notify you when a server disk fills up or CPU usage spikes unexpectedly.

USE CASE 4

Back up monitoring data automatically to an S3-compatible storage bucket on a schedule.

What is it built with?

GoDockerS3OAuth2

How does it compare?

henrygd/beszeldgraph-io/dgraphgetsops/sops
Stars21,64421,66921,702
LanguageGoGoGo
Setup difficultyeasymoderatemoderate
Complexity2/54/53/5
Audienceops devopsdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min
Use freely for any purpose including commercial, modify and distribute with attribution, just keep the MIT license notice.

In plain English

Beszel is a lightweight self-hosted tool for monitoring servers. If you run one or more servers, whether personal machines, home lab setups, or small production systems, Beszel gives you a web dashboard where you can see at a glance how each server is performing: CPU usage, memory, disk usage and read/write speed, network traffic, system temperature, and more. It also tracks Docker containers (packaged apps running in isolated environments) individually, showing their CPU, memory, and network usage over time. The system is built around two components. The hub is the central web application you visit in your browser to see all your server metrics. The agent is a small program you install on each server you want to monitor, it collects the metrics locally and sends them back to the hub. This hub-and-agent design means you only need a web browser to view data, and the agents running on your servers stay small and unobtrusive. Beyond basic monitoring, Beszel supports configurable alerts so you can be notified when something goes wrong, such as CPU usage spiking or a disk filling up. It can back up its own data to a local folder or to S3-compatible cloud storage (a common standard for object storage). It supports multiple users, with each user managing their own systems, and administrators able to share systems across users. Login can be handled by username and password or via OAuth2, a standard sign-in method that lets you use an existing account from another provider. You would use Beszel when you want a simple, low-resource way to keep an eye on one or more servers without complex setup. It is written in Go and licensed under the MIT license.

Copy-paste prompts

Prompt 1
I want to self-host Beszel to monitor my three Linux servers. Walk me through installing the hub and deploying an agent on each server.
Prompt 2
How do I configure Beszel alerts to send a notification when disk usage on any monitored server exceeds 85 percent?
Prompt 3
Set up Beszel with OAuth2 login using GitHub as the identity provider so my team can log in without separate passwords.
Prompt 4
How do I configure Beszel to back up its monitoring data to an S3-compatible bucket like Cloudflare R2 or Backblaze B2?
Prompt 5
I am running several Docker containers on my server. How does Beszel track per-container CPU and memory usage alongside host metrics?

Frequently asked questions

What is beszel?

Beszel is a lightweight self-hosted server monitor with a web dashboard showing CPU, memory, disk, and Docker container metrics in real time, with configurable alerts and backup support.

What language is beszel written in?

Mainly Go. The stack also includes Go, Docker, S3.

What license does beszel use?

Use freely for any purpose including commercial, modify and distribute with attribution, just keep the MIT license notice.

How hard is beszel to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is beszel for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub henrygd on gitmyhub

Verify against the repo before relying on details.