Unraid
tinkerologie/ha-unraid · vv2026.10.4
Monitor and control your Unraid server directly from Home Assistant. Track system metrics (CPU, RAM, disk usage), manage VMs and Docker containers, monitor UPS status, and receive real-time alerts. Features automated discovery and an easy-to-use interface for seamless integration with your smart home.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) |
What people report
Reads Unraid servers over the GraphQL API; setups without a traditional array and some motherboards' CPU temperature sensors caused problems.
- Partly works1
- Not working2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| UPS with NOMPOWER attribute (APC-style) | Partly works | Power usage computed from NOMPOWER and LOADPCT; UPS lacking NOMPOWER shows noneSaved copy… my server to reduce power consumption and it would have been nice to see live power consumption stats. Not sure if this is a bug or a quirk of my APS UPS model (Unraid shows it as Back-UPS ES 550G, but official model is APC BE550G Back-UPS ES 8 Outlet 550VA 120V) In a previously related closed issue I saw something regarding NOMPOWER. Could it be that my UPS unit does not provide this? --- ### Expected Behavior To be able to see a live (or close enough) power consumption of my unraid through the UPS. --- ### Steps To Reproduce (if applicable) See screenshot --- ### Screenshots --- ### Debug … Excerpt saved from GitHub on 2026-10-23. | Issue #76 · 2025-04 | |
| ASRock Z790M-ITX with Intel i7-13700K | Not working | CPU temperature unknown and motherboard temp wrong after attempted fixSaved copyasrock z790m-itx i7-13700k - no cpu temp unknown MB temp also not correct 120 C should be 49 C List of sensors... coretemp-isa-0000 Adapter: ISA adapter Package id 0: +47.0°C (high = +80.0°C, crit = +100.0°C) Core 0: +39.0°C (high = +80.0°C, crit = +100.0°C) Core 4: +42.0°C (high = +80.0°C, crit = +100.0°C) Core 8: +41.0°C (high = +80.0°C, crit = +100.0°C) Core 12: +39.0°C (high = +80.0°C, crit = +100.0°C) Core 16: +43.0°C (high = +80.0°C, crit = +100.0°C) Core 20: +40.0°C (high = +80.0°C, crit = +100.0°C) Core 24: +43.0°C (high = +80.0°C, crit = +100.0°C) Core 28: +39.0°C (high = +80.0°C, … Excerpt saved from GitHub on 2026-10-23. | Issue #43 · 2024-12 | |
| Unraid server with disk pool and no array | Not working Local | Setup fails with HTTP 400 in version 2026.3.1Saved copy… wird erneut versucht: API error: HTTP error 400: Bad Request" Tried: - Restarting HA -> not working - Reloading Integration -> not working - Remove/add unraid configuration -> not working - Downgrading to 2026.3.0 -> not working - Downgrading to 2026.3.0 and remove/add unraid -> not working - Downgrading to 2026.2.3 -> not working - Downgrading to 2026.2.3 and remove/add unraid -> not even possible to add (that was the pytantic issue something) ### 🔄 Steps to Reproduce upgrade to latest ha-unraid ### ✅ Expected Behavior connects ### 📂 Bug Category Setup/Configuration - Config flow, API … Excerpt saved from GitHub on 2026-10-23. | Issue #194 · 2026-03 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Details
| Installs (analytics) | 1,418 (0.2%) |
|---|---|
| GitHub stars | 257 |
| Latest version | v2026.10.4 (2026-10-21) |
| Set up in the UI | Yes |
| Maintainers | @ruaan-deysel |
| License | Apache-2.0 |
Limitations from the README
- GraphQL API Required: This integration requires the Unraid GraphQL API v4.31.1 or later. The API can be updated independently of the Unraid OS version, install the Unraid Connect plugin to keep it updated
- No Network Discovery: Unraid servers must be manually configured (no SSDP/mDNS discovery)
- Disk SMART Data: SMART queries can be slow on large arrays; storage polling is less frequent to compensate
- Container/VM Actions: Start/stop operations may take up to 60 seconds to complete
- SSL Certificates: Self-signed certificates require enabling "Allow insecure connections" (or configuring custom CA)
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/tinkerologie/ha-unraid
- Source code: https://github.com/tinkerologie/ha-unraid
- Issues: https://github.com/tinkerologie/ha-unraid/issues
- HACS: https://hacs.xyz