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
- Modernize dev tooling (esbuild, TypeScript 5.9 pin, testing-action-check v2)
- Error deduplication, auth backoff, protect against empty system list deletion
- Adapter timer methods, synchronous onUnload, merge About tab, Windows/macOS CI, full MIT license
- 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
Older changelog: CHANGELOG.md
This adapter is free and open source. If you find it useful, consider buying me a coffee:
MIT License
Copyright (c) 2026 krobi krobi@power-dreams.com
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Developed with assistance from Claude.ai
