# 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 users a richer dashboard than Unraid's built-in web interface. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2876/hass-unraid

## Description

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.

## Health score

75/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 11 days ago)
- Popular: 48 (261 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 100 (no serious findings, CI, tests)

## Links

- GitHub: https://github.com/domalab/ha-unraid
- Unraid: https://ca.unraid.net/apps/hass-unraid-1rjru141mxnt7g?q=hass-unraid

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/2876/hass-unraid), the self-hosted and open-source app directory.
