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…
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
Variants
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