Zabbix Agent for Unraid

The official static Zabbix 7.0 LTS agent (zabbix_agentd) as a native Unraid plugin. It sees the host directly — CPU, memory, disks, filesystems, network, the array — without a container or bind mounts.

The plugin downloads the agent from cdn.zabbix.com and checks its SHA256; nothing is rebuilt. Agent 7.0 works with Zabbix server 7.0 and newer.

Support: Unraid forum thread

Install

Unraid → Plugins → Install Plugin, paste:

https://github.com/vrx-666/unraid-zabbix-agent/releases/latest/download/zabbix-agent.plg

Configuration

Settings → Network Services → Zabbix Agent:

The options are those of the Zabbix agent, described in the Zabbix documentation. Apply checks the settings with the agent first: if it rejects them, nothing is saved and the error is shown. Otherwise the agent restarts with them.

Everything is stored in one file, /boot/config/plugins/zabbix-agent/zabbix_agentd.conf, which survives plugin updates and removal. You can also edit it by hand and run /etc/rc.d/rc.zabbix-agent restart.

On the Zabbix server, add the host with the "Linux by Zabbix agent" template and, for the array and disks, the "Unraid by Zabbix agent" template (see Unraid keys).

The static agent from Zabbix is built without TLS, so the traffic between agent and server is not encrypted.

Security

The agent runs as root, because SMART needs it. To keep a compromised Zabbix server from using it against Unraid, only the keys of the "Linux by Zabbix agent" template and the Unraid keys below are allowed; everything else (system.run, reading arbitrary files, web requests, port checks, ...) is denied, and no allowed key accepts .. in its parameters. The rules are in /etc/zabbix/ and are replaced on every update. To allow more keys, add AllowKey= lines under Advanced: your settings are read before the plugin's rules, so they win. Keys with .. in a parameter stay denied whatever you allow.

./test.sh checks this against the real agent: every template key works, the dangerous ones are denied.

Unraid keys

The template zbx_unraid_by_zabbix_agent.yaml (also attached to every release) uses them: array state, and for every array and pool disk its status, errors, temperature and SMART health, with triggers. Import it in Data collection > Templates > Import (Zabbix 7.0 or newer). The temperature threshold is the macro {$UNRAID.DISK.TEMP.MAX} (50 °C); set it per disk with a context, e.g. {$UNRAID.DISK.TEMP.MAX:"cache"}.

Updates and tests

New Zabbix 7.0.x agents are picked up automatically: a daily job opens a pull request with the new version and its SHA256, and a release follows once it is merged. ./test-unraid.sh <version> unpacks an Unraid release and, in a chroot, installs the plugin with Unraid's own plugin manager, queries the agent and the Unraid keys, runs the settings page's save logic under that release's PHP and removes the plugin. CI runs it on 7.0.0, the latest of each 7.x line and the current beta/rc.

License

Zabbix is licensed under the AGPL-3.0; the plugin files in this repository are under the same licence.