--- title: "Unraid Management Agent" description: "Unraid Management Agent is a Marketplace integration for Home Assistant. It has 271 installs sharing analytics, works locally and was last updated October 26, 2026." canonical: "https://vulpo.app/integrations/marketplace/tinkerologie-ha-unraid-management-agent" url: "https://vulpo.app/integrations/marketplace/tinkerologie-ha-unraid-management-agent.md" last-updated: "2026-10-25" version: "1.4" --- # Unraid Management Agent > Unraid Management Agent is a Marketplace integration for Home Assistant. It has 271 installs sharing analytics, works locally and was last updated October 26, 2026. Unraid Management Agent connects Home Assistant to the Unraid Management Agent running on an Unraid server. It adds sensors, binary sensors, switches, buttons, numbers, events and update entities for the array, parity checks, Docker containers, virtual machines, disks, fans, GPUs, network cards and ZFS pools. Actions cover starting, stopping and restarting containers and VMs, plus array and parity check control. Data arrives over a local WebSocket connection, with polling every 30 seconds as a fallback. A read-only mode limits the integration to sensors so Home Assistant cannot start, stop or reboot anything on the server. It is found automatically on the network and set up in the UI, and it bundles custom dashboard cards and shows repair notices for problems such as disk errors or a failed connection. Automatic summary of the README and code of tinkerologie/ha-unraid-management-agent. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=tinkerologie&repository=ha-unraid-management-agent&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=tinkerologie&repository=ha-unraid-management-agent&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Found by itself**: Home Assistant spots it on the network and offers to add it. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Connect to Unraid Server - **Host** - **Port** - **Enable WebSocket for real-time updates** - **API token**: Required if an API token is set in the agent's settings (Settings \> Unraid Management Agent \> Authentication). Leave empty if authentication is disabled. Also asked when changing the connection. ### Reauthenticate Unraid Management Agent - **API token**: The API token currently set in the agent's settings (Settings \> Unraid Management Agent \> Authentication). It is sent as a bearer token on every request. ### After setup - **Enable container update checks**: Periodically check Docker containers for available image updates. This may slow down polling and use additional network requests. Also creates an update entity for each container, from which its image update can be installed. - **Enable fan control entities**: Create fan speed sensor and control entities. Disable if your system does not have controllable fans. - **Enable read-only mode (sensors only)**: Only create sensors. Switches, buttons, and number controls are not created (existing ones are removed), and the integration's actions refuse to run, so Home Assistant cannot start, stop, or reboot anything on the server. Update entities still show available updates but do not offer to install them. - **Enable WebSocket for real-time updates**: WebSocket provides instant updates instead of polling. When disabled, data is polled every 30 seconds. - **Show Docker containers as separate devices**: Give each container its own device under the server's Docker device, holding its switches, restart button, and metric sensors with short names (Running, CPU, Memory). When off, container entities stay on the server device, named after the container. - **Show GPUs as separate devices**: Give each GPU its own device under the server, holding its utilization, temperature, power, energy, and VRAM sensors with short names. When off, GPU sensors stay on the server device, named after the GPU. - **Show network cards as separate devices**: Give each PCI network card its own device under the server, with its ASIC, PHY, and MAC temperatures, and per port the link speed and the plugged optic's diagnostics (module temperature and voltage, RX and TX power, alarm and warning flags, vendor and part number). Needs an agent that reports network cards. When off, no network card entities are created (existing ones are removed). - **Show USB sensor controllers as separate devices**: Give each USB sensor controller the agent identifies (for example an Aquacomputer Octo) its own device under the server, holding its fan and temperature sensors named by their lm-sensors labels ("Array Fan1", "Coolant Temp"). Entity IDs are kept. When off, these sensors stay on the server device. A channel labelled as flow in sensors.conf ("Coolant Flow") is shown as a flow channel either way; it still reports RPM. - **Show virtual machines as separate devices**: Give each VM its own device under the server's VMs device, holding its power switch, control buttons, and metric sensors (CPU, memory, network, and disk rates). When off, VM switches and buttons stay on the server device, and no VM sensors are created. - **Show ZFS pools as separate devices**: Give each ZFS pool its own device under the server, holding its usage, health, scrub, and error sensors with short names, plus drive health roll-ups: hottest drive temperature, worst NVMe wear, media errors, failing drives, and a drive count with per-drive details. Drive health needs agent 2026.10 or later. When off, pool entities stay on the server device, named after the pool. - **CPU temperature source**: Where the CPU temperature sensor gets its value. "Automatic" uses the CPU temperature the agent reports. If that shows the wrong chip on your board (for example a motherboard channel such as nct6798 CPUTIN instead of k10temp Tctl), pick the hwmon channel to use instead. The sensor is unavailable while the picked channel is not reported. Texts from the code of [tinkerologie/ha-unraid-management-agent](https://github.com/tinkerologie/ha-unraid-management-agent). ## Entities - **Binary sensors**: Array Started, Parity Check Running, Parity Valid, UPS Connected, ZFS Available, Update Available, Flash Healthy, Mover Running, Parity Check Scheduled, Service, Container Updates Available, Status, and 7 more - **Buttons**: Start Array, Stop Array, Clear Array Disk Stats, Start Parity Check, Stop Parity Check, Pause Parity Check, Resume Parity Check, Archive All Notifications, Shutdown System, Reboot System, Force stop, Restart, and 3 more - **Events**: Notification, Alert - **Sensors**: CPU Usage, RAM Usage, CPU Temperature, Motherboard Temperature, CPU Power, DRAM Power, Uptime, Chipset Temperature, CPU Governor, CPU Frequency, Swap Usage, Swappiness, and 89 more - **Switches**: Power, Running, Autostart - **Updates**: Unraid OS, Image ## Actions - **Start Container**: Start a Docker container Fields: Container ID - **Stop Container**: Stop a Docker container Fields: Container ID - **Restart Container**: Restart a Docker container Fields: Container ID - **Pause Container**: Pause a running Docker container Fields: Container ID - **Resume Container**: Resume a paused Docker container Fields: Container ID - **Remove Container**: Remove a Docker container Fields: Container ID, Remove Image - **Set Container Autostart**: Enable or disable autostart for a Docker container Fields: Container ID, Enabled - **Start VM**: Start a virtual machine Fields: VM ID - **Stop VM**: Stop a virtual machine Fields: VM ID - **Restart VM**: Restart a virtual machine Fields: VM ID - **Pause VM**: Pause a running virtual machine (suspend to RAM) Fields: VM ID - **Resume VM**: Resume a paused virtual machine Fields: VM ID - **Hibernate VM**: Hibernate a virtual machine (suspend to disk) Fields: VM ID - **Force Stop VM**: Force stop a virtual machine (equivalent to power off) Fields: VM ID - **Reset VM**: Force reset a virtual machine Fields: VM ID - **Start Array**: Start the Unraid array - **Stop Array**: Stop the Unraid array - **Clear Array Disk Stats**: Clear array disk read/write statistics - **Start Parity Check**: Start a parity check - **Stop Parity Check**: Stop the running parity check ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: Connection to Unraid Server Failed, Disk SMART Errors Detected, Disk High Temperature Warning, Disk Critical Temperature, Array Parity Invalid, Parity Check May Be Stuck ## From the README > This custom integration connects Home Assistant to the Unraid Management Agent (UMA) running on your Unraid server. It delivers comprehensive monitoring, interactive controls, dynamic entity discovery, real-time WebSocket telemetry, and a bundled suite of custom Lovelace dashboard cards. From the README of [tinkerologie/ha-unraid-management-agent](https://github.com/tinkerologie/ha-unraid-management-agent#readme), [Apache License 2.0](https://spdx.org/licenses/Apache-2.0.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Computers and network](https://vulpo.app/integrations/category/computers-and-network.md), NAS and servers - Brand: [Unraid](https://vulpo.app/integrations/unraid.md) - Number: 271 installs sharing analytics; 48 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v2026.10.1, last updated October 26, 2026 - Domain: `unraid_management_agent` - Source: - Issues: In Vulpo: Quick Toggle card, Button card, Chart card, Apple Watch, Control Center ## Other ways in for Unraid | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Unraid](https://vulpo.app/integrations/marketplace/tinkerologie-ha-unraid.md) | Marketplace integration | 1.4k installs sharing analytics | Works locally | Updated in the last 6 months | | [Unraid API](https://vulpo.app/integrations/marketplace/chris-mc1-unraid-api.md) | Marketplace integration | 381 installs sharing analytics | Works locally | Updated in the last 6 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-25. Source: https://vulpo.app/integrations/marketplace/tinkerologie-ha-unraid-management-agent --- - HTML version of this page: https://vulpo.app/integrations/marketplace/tinkerologie-ha-unraid-management-agent - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml