Connects to a Beszel Hub and exposes server monitoring metrics for all registered systems as ioBroker states.
- Fetches metrics from all systems registered in your Beszel Hub
- Per-system states: CPU, memory, disk, network, temperature, load average
- Optional: GPU metrics, Docker/Podman containers, battery, extra filesystems, CPU breakdown, systemd services
- Configurable poll interval (10–300 seconds)
- Automatic token refresh (every 23 hours) and re-authentication on 401
- Connection test button directly in the admin UI
- Automatic cleanup of states for removed systems and disabled metrics
- Node.js >= 20
- ioBroker js-controller >= 7.0.0
- ioBroker Admin >= 7.6.20
- A running Beszel Hub with at least one registered system
| Option | Description | Default |
|---|---|---|
| Beszel Hub URL | Full URL of your Beszel Hub (e.g. http://192.168.1.100:8090) |
— |
| Username | Beszel Hub login email/username | — |
| Password | Beszel Hub password | — |
| Poll Interval (s) | How often to fetch data from the Hub | 60 |
Use the Test Connection button to verify your credentials before saving.
All metrics are global toggles that apply to all systems. Disabled metrics are automatically removed from the state tree on the next adapter start.
| Group | Metric | Default |
|---|---|---|
| System | Uptime | on |
| Agent Version | off | |
| Systemd Services (total / failed) | off | |
| CPU | CPU Usage (%) | on |
| Load Average (1m / 5m / 15m) | on | |
| CPU Breakdown (User / System / IOWait / Idle) | off | |
| Memory | Memory Usage (% and GB) | on |
| Memory Details (Buffers, ZFS ARC) | off | |
| Swap | off | |
| Disk | Disk Usage (% and GB) | on |
| Disk Read/Write Speed | on | |
| Additional Filesystems | off | |
| Network | Network Traffic (Upload / Download MB/s) | on |
| Temperature | Temperature (hottest sensors avg) | on |
| Individual Temperature Sensors | off | |
| GPU | GPU Metrics (Usage, Memory, Power) | off |
| Containers | Container Monitoring (Docker / Podman) | off |
| Battery | Battery Status | off |
beszel.0.
├── info.connection — Connection status (bool)
└── systems.
└── {system_name}/ — Device (sanitized name)
├── online — Is system up? (bool)
├── status — Status string (up/down/paused/pending)
├── uptime — Uptime in seconds
├── uptime_text — Human-readable uptime (e.g. "14d 6h")
├── cpu_usage — CPU %
├── memory_percent — RAM %
├── memory_used — RAM used (GB)
├── disk_percent — Disk %
├── network_sent — Upload (MB/s)
├── network_recv — Download (MB/s)
├── temperature — Avg temperature (°C)
├── temperatures/ — Individual sensors (if enabled)
├── gpu/ — GPU metrics (if enabled)
├── filesystems/ — Extra filesystems (if enabled)
└── containers/ — Container metrics (if enabled)
- Verify the Hub URL is reachable from the ioBroker host
- Check username and password (use the Test Connection button)
- Check that no firewall blocks access to the Beszel Hub port
- Check the ioBroker log for errors from the
beszeladapter - Ensure the poll interval is not too short (minimum 10 seconds)
- Check
info.connectionstate — iffalse, authentication failed
- The system may be
downorpausedin Beszel — no stats records exist yet - Verify the metric is enabled in the adapter configuration
- Logging cleanup: stale system removal moved to debug level
- Add online/offline indicator to system device folders
- Add system count to startup log message
- Code cleanup: remove dead code, fix duplicate container filter, extract load avg helper
- Migrate to @alcalzone/release-script, enable npm Trusted Publishing
- Fix all repochecker issues; rename repo to ioBroker.beszel; add responsive grid sizes
Older changelog: CHANGELOG.md
This adapter is free and open source. If you find it useful, consider buying me a coffee:
MIT License - see LICENSE
Copyright (c) 2026 krobi krobi@power-dreams.com
Developed with assistance from Claude.ai
