Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

Home Assistant Unraid Integration

Featured Replies

  • Author
On 1/13/2025 at 8:53 AM, PanicMechanic007 said:

You can look into whitelist / suppress the HA IP so that it doesn't show in the logs.
https://github.com/domalab/ha-unraid/wiki/Troubleshooting/_edit#ssh-session-log-spam

I made improvements to the ssh based integration to reduce log spam and overall amount of ssh connections the integration makes to unraid server.

You can also try out the beta version of the Unraid Connect integration that uses the Unraid API. See latest post

  • 3 weeks later...

I love it!

Thanks a lot

Screenshot 2025-06-24 at 14.24.08.png

  • 3 weeks later...

Hi

Im testing the beta of GraphQL API integration for HA and it looks promising. Im using UnraidAPI docker container for docker/vm/unraid control and Glances for monitoring sensors and the goal is to replace them bnoth with this by using the GraphQL API.

While testing i wanted to test restarting containers and saw this on the github info:

Docker Services

  • unraid.docker_restart: Restart a container

  • unraid.docker_logs: Get container logs

But when i select the service there are no selectable target and i dont get the container attribute id in HA.

I couldnt find if the services are available yet on github info. Are they availble and something wrong with my setup or are they not running yet?

  • 2 months later...

I'm trying to set this up to start a VM when power to an HDMI extender is turned on... Seems like it should work but I get stuck as soon as I try to "Add new Unraid Server"

Web Address: https://10.40.70.xxx

API Key PAsted in

Verify SSL certificate is checked

But I get SSL Error when connecting to Unraid

or it just reports "Failed to connect to Unraid"

  • 1 month later...
On 6/24/2025 at 8:24 AM, dam_j said:

I love it!

Thanks a lot

Screenshot 2025-06-24 at 14.24.08.png

Beautiful! How you getting CPU temp? Looking at the GraphQL sandbox, I don't see temperature options either under metrics → cpu or info → cpu.

  • 3 weeks later...

I insert my IP and the API key and then I cannot connect with Home Assistant. I receive the following message: Unraid: GraphQL operations must contain a non-empty query or a persistedQuery extension. What's wrong with my configuration?

Edited by Walki

  • 2 weeks later...
On 11/18/2025 at 4:21 PM, Walki said:

I insert my IP and the API key and then I cannot connect with Home Assistant. I receive the following message: Unraid: GraphQL operations must contain a non-empty query or a persistedQuery extension. What's wrong with my configuration?

I'm just trying to set it up and I'm getting the same error when I start.

  • 2 weeks later...
  • Author
On 11/19/2025 at 7:21 AM, Walki said:

I insert my IP and the API key and then I cannot connect with Home Assistant. I receive the following message: Unraid: GraphQL operations must contain a non-empty query or a persistedQuery extension. What's wrong with my configuration?

Hello, I think you can bypass the GraphQL errors by turning off SSL/TLS in unraid under management access and then try the Unraid API integration again.

https://github.com/chris-mc1/unraid_api/issues/18#issuecomment-3577331567

Other option is to install Unraid Management Agent plugin then you can use the HA Unraid Management Agent integration

https://github.com/ruaan-deysel/ha-unraid-management-agent

Once installed via HACS and you search for Unraid Management Agent in integrations to configure it

Screenshot 2025-12-15 at 8.55.52 am.png

All you have to do is enter your unraid server IP address and click Submit.

Screenshot 2025-12-15 at 8.54.41 am.png

You are all done and should show entities for your unraid server

Edited by PanicMechanic007

On 12/14/2025 at 5:59 PM, PanicMechanic007 said:

Other option is to install Unraid Management Agent plugin then you can use the HA Unraid Management Agent integration

https://github.com/ruaan-deysel/ha-unraid-management-agent

Once installed via HACS and you search for Unraid Management Agent in integrations to configure it

Screenshot 2025-12-15 at 8.55.52 am.png

All you have to do is enter your unraid server IP address and click Submit.

Screenshot 2025-12-15 at 8.54.41 am.png

You are all done and should show entities for your unraid server

That Unraid Management Agent is fantastic! I've fought with the first party one for too long, this one just works... and real-time. Thank you for mentioning it!

On 12/14/2025 at 11:59 PM, PanicMechanic007 said:

Hello, I think you can bypass the GraphQL errors by turning off SSL/TLS in unraid under management access and then try the Unraid API integration again.

https://github.com/chris-mc1/unraid_api/issues/18#issuecomment-3577331567

Other option is to install Unraid Management Agent plugin then you can use the HA Unraid Management Agent integration

https://github.com/ruaan-deysel/ha-unraid-management-agent

Once installed via HACS and you search for Unraid Management Agent in integrations to configure it

Screenshot 2025-12-15 at 8.55.52 am.png

All you have to do is enter your unraid server IP address and click Submit.

Screenshot 2025-12-15 at 8.54.41 am.png

You are all done and should show entities for your unraid server

Hello @PanicMechanic007 ,
I installed your plugin, and it’s truly impressive in terms of features and completeness.
However, I had to uninstall it because it drastically increased the power consumption of my Unraid server. I went from around 30 W continuously (25 Docker containers + 1 VM) to 45–50 W continuously.

To confirm, I tried reinstalling it, with the same result.

Unfortunately, this is a deal-breaker for me. I can’t afford a 50–60% increase in power consumption.

Do you think it would be possible to improve this?
Do you know what causes such a high CPU load with your plugin?
Too high refresh rate, background tasks, something else?

If this part gets optimized, I’d be happy to run tests again and share my results with you.

Thanks in advance,
Ferywir

https://github.com/ruaan-deysel/ha-unraid-management-agent/issues/8

Edited by Ferywir

  • 4 weeks later...

Hey, i got this message from "Fix common problems" today
grafik.png
and noticed that /var/log is over 100MB in size
grafik.png

I checked the log folder and noticed this:
grafik.png

As you can see, the unraid-management-agent fills my /var/log folder every day with a 5MB file, which in general is not that large, but it adds up and is currently consumes 80MB of /var/log.

When i looked into the log files, i noticed that it spammed the same stuff over and over again for thousends of lines. I have attached the latest log file for analysis.

unraid-management-agent-2026-01-09T20-02-58.401.log

Also there seems to be some problem with dark theme unraid:
grafik.png

  • Author
On 1/10/2026 at 6:01 PM, Joly0 said:

Also there seems to be some problem with dark theme unraid:
grafik.png

Thanks. I'll check and update the code

  • Author
On 1/10/2026 at 6:01 PM, Joly0 said:

Also there seems to be some problem with dark theme unraid:
grafik.png

On 1/10/2026 at 5:59 PM, Joly0 said:

Hey, I hangot this message from "Fix common problems" today
grafik.png
and noticed that /var/log is over 100MB in size
grafik.png

I checked the log folder and noticed this:
grafik.png

As you can see, the unraid-management-agent fills my /var/log folder every day with a 5MB file, which in general is not that large, but it adds up and is currently consumes 80MB of /var/log.

When i looked into the log files, i noticed that it spammed the same stuff over and over again for thousends of lines. I have attached the latest log file for analysis.

unraid-management-agent-2026-01-09T20-02-58.401.log

Thanks. I have noticed this as well and have made updates to clean up old logs automatically

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.