Unraid for Home Assistant (Marketplace integration)

Installs: 1.4k sharing analytics
GitHub stars: 257
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v2026.10.5, October 26, 2026
Category: Computers and network, NAS and servers
Kind: Marketplace integration
Brand: Unraid
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: unraid
Source: github.com/tinkerologie/ha-unraid
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Unraid is a Home Assistant integration that monitors and controls an Unraid server through its GraphQL API. It adds sensors for CPU, memory, swap, array, parity and disk status, plus binary sensors for items such as parity validity, safe mode and mover activity. Switches start and stop the array, parity checks, Docker containers and virtual machines, and buttons pause or resume parity checks and update containers. UPS monitoring covers battery level, load and runtime, and a power sensor for the Energy Dashboard needs the nominal wattage entered in the options. An optional setting creates update entities for Docker containers, and an events entity reports Unraid notifications. It runs locally, is set up in the UI with host, port and an API key with the admin role, and needs a recent Unraid GraphQL API.

Automatic summary of the README and code of tinkerologie/ha-unraid. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect to Unraid

HostIP address (for example, 192.168.1.100) or hostname/domain of your Unraid server.
PortHTTP port number (default: 80). Secure connections are handled automatically.
API keyGenerate in Unraid Settings → Management Access → API Keys. Requires ADMIN role.

Reauthenticate Unraid

API keyGenerate a new API key in Unraid Settings → Management Access → API Keys

Reconfigure Unraid

HostIP address or hostname of your Unraid server.
PortHTTP port number (default: 80). Secure connections are handled automatically.
API keyAPI key with ADMIN role permissions.

After setup

Enable container update sensorsWhen enabled, creates an update entity for each Docker container to track available image updates. Disable if you manage container updates externally or don't need update notifications.
UPS capacity (VA)Optional. Your UPS VA rating (e.g., 1000 for a 1000VA UPS). Shown in sensor attributes for reference.
UPS nominal power (W)Required for UPS Power sensor. Enter the Watts value from your UPS specs. If Unraid only shows VA, check your UPS label or estimate using VA × 0.6.

Texts from the code of tinkerologie/ha-unraid.

Entities

Binary sensorsParity status, Array started, Parity check running, Parity check paused, Parity valid, Cloud connected, Remote access, Mover active, Disks disabled, Disks missing, Disks invalid, Safe mode, and 3 more
ButtonsParity check (correcting), Pause parity check, Resume parity check, Archive all notifications, Delete all archived notifications, Update all containers, Check container updates, Recalculate notifications
EventsNotifications
SensorsCPU usage, CPU temperature, CPU power, RAM usage, RAM used, Swap usage, Swap used, RAM buffer/cache, RAM active, Swap free, Temperature average, Unraid version, and 24 more
SwitchesArray, Parity check

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:Authentication Failed

From the README

A Home Assistant custom integration for monitoring and controlling Unraid servers via the official GraphQL API.
Note: This integration requires the Unraid GraphQL API v4.31.1 or later. The API can be updated independently of the Unraid OS version by installing the Unraid Connect plugin from the Unraid Community Applications store.
CPU Usage: Real-time CPU utilization percentage
CPU Temperature: Package temperature monitoring
CPU Power: Power consumption (when available)
Memory Usage: Used memory and percentage utilization
System Uptime: Human-readable uptime display

From the README of tinkerologie/ha-unraid, Apache License 2.0. Shortened.