Ansible role: Beszel monitoring hub (Docker, behind a reverse proxy)
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Paul Provost 4a1d092191 Manage alert notification targets and per-system alert rules
beszel_hub_webhooks sets the admin's shoutrrr URLs, and beszel_hub_alerts
applies rules to every system in beszel_hub_systems, matched by system
and name.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 15:31:36 -04:00
defaults Manage alert notification targets and per-system alert rules 2026-10-27 15:31:36 -04:00
meta Add beszel-hub role: Beszel hub container behind the reverse proxy 2026-10-27 14:41:30 -04:00
tasks Manage alert notification targets and per-system alert rules 2026-10-27 15:31:36 -04:00
README.md Manage alert notification targets and per-system alert rules 2026-10-27 15:31:36 -04:00

ansible-role-beszel-hub

Deploys the Beszel monitoring hub (henrygd/beszel) as a Docker container on a network shared with the reverse proxy, which reaches it as beszel:8090. The host port is bound to loopback only.

Variables

Variable Default Notes
beszel_hub_app_url (required) Public https:// URL of the dashboard
beszel_hub_user_email / _password (required) First admin, applied only when the database is created
beszel_hub_image henrygd/beszel:0.21.1 Pinned; bump deliberately
beszel_hub_dir ~/local/beszel Database and the hub's SSH key pair
beszel_hub_network_name proxy Docker network shared with Caddy
beszel_hub_host_port 8090 Loopback-only
beszel_hub_extra_env {} Extra hub environment variables
beszel_hub_systems [] {name, host, port} agents to register, by name; UI-added systems are left alone
beszel_hub_webhooks [] Shoutrrr URLs for the admin's alerts (replaces the UI's list)
beszel_hub_alerts [] {name, value, min} rules applied to every system in beszel_hub_systems

The role prints the hub's public key at the end; agents need it as KEY.