https://github.com/henrygd/beszel
Lightweight server monitoring hub with historical data, docker stats, and alerts.
https://github.com/henrygd/beszel
homelab monitoring self-hosted
Last synced: 4 days ago
JSON representation
Lightweight server monitoring hub with historical data, docker stats, and alerts.
- Host: GitHub
- URL: https://github.com/henrygd/beszel
- Owner: henrygd
- License: mit
- Created: 2024-07-07T21:36:28.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-03-28T21:04:47.000Z (17 days ago)
- Last Synced: 2025-04-03T15:03:22.215Z (11 days ago)
- Topics: homelab, monitoring, self-hosted
- Language: Go
- Homepage: https://beszel.dev
- Size: 3.89 MB
- Stars: 10,485
- Watchers: 22
- Forks: 313
- Open Issues: 178
-
Metadata Files:
- Readme: readme.md
- Funding: .github/funding.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-homelab - Beszel
- my-awesome - henrygd/beszel - hosted pushed_at:2025-04 star:10.5k fork:0.3k Lightweight server monitoring hub with historical data, docker stats, and alerts. (Go)
- awesome-repositories - henrygd/beszel - Lightweight server monitoring hub with historical data, docker stats, and alerts. (Go)
- RAWR - beszel - Lightweight server monitoring hub with historical data, docker stats, and alerts. (Other / Web Applications)
- awesome - henrygd/beszel - Lightweight server monitoring hub with historical data, docker stats, and alerts. (Go)
- StarryDivineSky - henrygd/beszel
- awesome-starred - henrygd/beszel - Lightweight server monitoring hub with historical data, docker stats, and alerts. (Go)
README
# 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.
[](https://hub.docker.com/r/henrygd/beszel-agent)
[](https://hub.docker.com/r/henrygd/beszel)
[](https://github.com/henrygd/beszel/blob/main/LICENSE)
[](https://crowdin.com/project/beszel)
## Features
- **Lightweight**: Smaller and less resource-intensive than leading solutions.
- **Simple**: Easy setup, no need for public internet exposure.
- **Docker stats**: Tracks CPU, memory, and network usage history for each container.
- **Alerts**: Configurable alerts for CPU, memory, disk, bandwidth, temperature, 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 and restore data from disk or S3-compatible storage.
- **REST API**: Use or update your data in your own scripts and applications.
## Architecture
Beszel consists of two main components: the **hub** and the **agent**.
- **Hub**: A web application built on [PocketBase](https://pocketbase.io/) that provides a dashboard for viewing and managing connected systems.
- **Agent**: Runs on each system you want to monitor, creating a minimal SSH server to communicate system metrics to the hub.
## Getting started
The [quick start guide](https://beszel.dev/guide/getting-started) and other documentation is available on our website, [beszel.dev](https://beszel.dev). You'll be up and running in a few minutes.
## Screenshots
## 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.
- **Temperature** - Host system sensors.
- **GPU usage / temperature / power draw** - Nvidia and AMD only. Must use binary agent.
## License
Beszel is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.