Hass-unraid

Hass-unraid is a Home Assistant custom integration that monitors and controls Unraid servers through the official Graph Query Language (GraphQL) API, giving…

  • Home Automation
  • Infrastructure
  • Tools & Utilities
Hass-unraid is a Home Assistant custom integration that monitors and controls Unraid servers through the official Graph Query Language (GraphQL) API, giving users a richer dashboard than Unraid's built-in web interface.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

75/100 Good

Maintained
100last commit 11 days ago
Popular
48261 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
100no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 21 days ago

GitHub stars
261
Open issues
7
Last commit
2026-11-10
Latest release
v2026.11.2
License
Apache-2.0
Activity
rising

Checked 7 days ago - source: GitHub (domalab/ha-unraid)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Add the card resource if installing manually If you install the card manually, copy its JavaScript file into Home Assistant's www (public files) folder and add the resource link in Lovelace (the dashboard editor). Without that link, the card can't load and you'll see a blank space or an error. source
  • Give the card a player and grouped speakers In the card settings, set entity_id (the player's address in Home Assistant) to the player you want to control, and list any grouped speakers under speaker_group. If that ID is missing or wrong, the card won't work, and missing grouped speakers means group playback won't be available. source
  • Combine sources with a Universal Media Player If you want one control to switch between several audio sources, add a Universal Media Player in configuration.yaml (Home Assistant's main settings file) and set an active_child_template (the rule that picks which player is active). Without a correct template, commands can go to the wrong child player and volume or playback may seem broken. source
  • Requirements Requires Unraid GraphQL API version 4.31.1 or later. The API can be updated independently of the Unraid OS version. source
  • Unraid Connect / API version Requires Unraid GraphQL API v4.31.1 or later; install or update the Unraid Connect plugin from the Community Applications store to update the API independently of Unraid OS. source

Fetched 2 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which Unraid API version is required for the integration?

It requires Unraid GraphQL API v4.31.1 or later. The API can be installed or updated independently using the Unraid Connect plugin.

Can I upgrade directly from the SSH-based release to the GraphQL-based release?

No, there is no direct migration or upgrade path from SSH to GraphQL. You need to remove the old integration and set it up fresh with a new API key, or stay on release 2025.06.11 if you prefer SSH.

How do I install it using HACS?

Add the repository in HACS, search for Unraid, download the integration, and restart Home Assistant.

Which Unraid workloads can it control from Home Assistant?

It can start and stop Docker containers and virtual machines. It also syncs their state and exposes related attributes such as image, status, and port information for containers.

What storage information does it monitor?

It monitors array status and capacity, parity check status and progress, per-disk health and usage, share usage, and flash device usage.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads