paul/ansible-role-beszel-agent
Watch
1
0
Fork
You've already forked ansible-role-beszel-agent
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Ansible role: Beszel monitoring agent (systemd, Homebrew or Docker)
2 commits 1 branch 0 tags 12 KiB
  • Jinja 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Paul Provost 8b1ef85a26 Install on macOS as a LaunchDaemon; run the Unraid container via the docker CLI 
- launchd method replaces brew: the formula builds from source when
  there is no bottle for the macOS version, and its tap needs trusting.
  The release binary is extracted with tar (unarchive can't use bsdtar)
  and the log is owned by the agent's user, or launchd fails with
  EX_CONFIG.
- docker method uses the docker CLI: Unraid's Python lacks requests.
- Unpack again whenever the binary is missing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 14:58:48 -04:00
defaults Install on macOS as a LaunchDaemon; run the Unraid container via the docker CLI 2026-10-27 14:58:48 -04:00
handlers Install on macOS as a LaunchDaemon; run the Unraid container via the docker CLI 2026-10-27 14:58:48 -04:00
meta Install on macOS as a LaunchDaemon; run the Unraid container via the docker CLI 2026-10-27 14:58:48 -04:00
tasks Install on macOS as a LaunchDaemon; run the Unraid container via the docker CLI 2026-10-27 14:58:48 -04:00
templates Install on macOS as a LaunchDaemon; run the Unraid container via the docker CLI 2026-10-27 14:58:48 -04:00
README.md Install on macOS as a LaunchDaemon; run the Unraid container via the docker CLI 2026-10-27 14:58:48 -04:00

README.md

ansible-role-beszel-agent

Installs the Beszel agent. It listens on beszel_agent_port (45876) and accepts only the hub whose public key is beszel_agent_key; the hub connects to it over SSH.

beszel_agent_method Where How
systemd (Linux default) Debian/Ubuntu Pinned release binary (checksum-verified) in /opt/beszel-agent, systemd unit modelled on upstream's, beszel user in the docker group when present
launchd (macOS default) Macs Pinned release binary (checksum-verified) in /opt/beszel-agent, LaunchDaemon dev.beszel.agent running as the login user. Not the Homebrew formula: it builds from source when there is no bottle for the macOS version.
docker Unraid henrygd/beszel-agent container (docker CLI, no Python SDK needed), host network, Docker socket read-only

Extra agent settings go in beszel_agent_extra_env.