Beszel Agent Add-on (with S.M.A.R.T. Support)

I’ve created a Home Assistant add-on for Beszel with S.M.A.R.T disk monitoring.

What’s Beszel?

Beszel is a lightweight server monitoring hub with historical data, docker stats, and alerts. It’s pretty efficient and doesn’t hog resources. Check out the Beszel repo to learn more.

Available add-on variants

The repository includes three variants:

  1. Beszel Agent - Standard version for basic monitoring

  2. Beszel Agent (S.M.A.R.T.) - Includes S.M.A.R.T. disk health monitoring

  3. Beszel Agent (Test) - Development/testing version

Installation and Setup

Click this button to add the repository:

Open your Home Assistant instance and show the add add-on repository dialog with this repository URL pre-filled.

Or add addon repository manually by following the step-by-step installation and setup guide with screenshots.

Permissions

This add-on uses some special permissions to work:

  • Host Network - for accurate network monitoring
  • Host D-Bus - to get system and running services info
  • Docker API - to see container stats
  • Full Hardware Access - to access disk devices for S.M.A.R.T. data

For Docker API and Full Hardware Access, you need to disable the protection mode for the add-on. Protection Mode restricts add-on access to the host system. It’s a security feature, but it limits what metrics Beszel can collect. Only disable it if you trust the add-on and beszel agent - it’s open source, but disabling protection does give it broader system access.

Release

I’ve set up GitHub Actions to check for new Beszel releases every 8 hours. When there’s an update, it runs through automated tests to make sure new image works properly before publishing a new add-on release.

2 Likes