Hey all! This started with a simple problem: I wanted to know when my Unraid array was running a parity check or disk rebuild so I could trigger a cooling fan automatically. There wasn't a reliable way to get that signal into Home Assistant, so I built a native plugin instead. Once that worked, I kept going, and now it publishes a pretty comprehensive set of server metrics to MQTT with full HA auto-discovery support.

---

What it monitors

• Array & Cache — status, capacity, used %, disk count, disabled/invalid/missing disks

• Parity & Rebuild — status, progress %, speed, and ETA (this is where it all started!)

• Disks — per-disk temp, state (Active/Standby/Disabled), SMART health, reallocated/pending/uncorrectable sectors, read/write speeds, power-on hours

• System — uptime, Unraid version, server ID, network RX/TX per interface, share usage

Each metric can be published on an interval, on-change, or both — so you're not flooding your broker unnecessarily.

---

Home Assistant

Entities appear automatically via MQTT discovery the moment the daemon starts. You get full sensor.unraid_* entities with state attributes for things like disk size, free/used GB, SMART details, and share metadata. No manual configuration needed.

A small taste of what shows up:

sensor.unraid_array_status
sensor.unraid_parity_status
sensor.unraid_parity_progress
sensor.unraid_disk1_temp
sensor.unraid_disk1_smart_health
sensor.unraid_net_eth0_rx
sensor.unraid_share_media_info

---

Installation

Go to Plugins → Install Plugin and paste:

https://raw.githubusercontent.com/maxandcheeses/unraid-stats2mqtt/refs/heads/main/plugin/unraid-stats2mqtt.plg

All settings are managed through the Unraid WebUI under Settings → Stats to MQTT. Supports plain MQTT, MQTTS (TLS), WS, and WSS — including mutual TLS and self-signed certs.

---

GitHub: https://github.com/maxandcheeses/unraid-stats2mqtt

This is an early release so feedback, bug reports, and feature requests are very welcome. Curious what metrics others would find useful, and would love to see what HA automations or dashboards people build with it!

Edited April 30Apr 30 by maxandcheese
Update App Name in topic

Although I wouldn't keep mon so much state of Unraid, but this plugin really cool.