UNRAID Integration

On the Github repo there’s a sponsor this project section.

Screenshot 2025-01-10 at 9.10.02 am

2 Likes

One thing that is a bit annoying with the integration using ssh to gather info is that it logs a few messages in syslog depending on how you configured the sensor update intervals.

To get around this I created a little script you run using the User Scripts plugin.

Suppress HA Unraid SSH logs

I tested it on Unraid 7.0 and works really well.

This is a really powerful plugin.but I encountered a problem when I installed homeassistant using UNRAID’s own docker, homeassistant’s unraid integration could not connect to UNRAID’s ssh, even the ssh of terminals using docker could not connect to the unraid system. However, ssh connection to other devices similar to the group is normal. I have set the container of homeassistant to another LAN ip under br0, but still can’t connect.It’s remind that Failed to connect to Unraid server.I think maybe its my system setting have some problems.
so how can i fix this problem? please help me! thanks!
(i just input this text by translate.hope you can understand!)

thats the screen picture of the problem:

thank you very much!!!

Set your home assistant unraid container network to use host network (unraid’s ip). That’s how I have it configured for my unraid container and then it should work. Also make sure you have SSH enabled on Unraid.

ok! thanks you! let me try

image
wow! thats great!
it’s working!
thank you very much!
(but i still want to know why i can’t use br0’s ip.hahaha.)

Assuming you’re br0 is macvlan and you want to assign home assistant container its own IP?

If so, then try ipvlan instead and enable allow access to host network under unraid docker settings.

Hi. Nice to see progress. I’m one of those people with two UNRAID boxes.

GREAT to see I can now tell the two servers apart easier. But I am not sure how I have done this, but I seem to have everything named twice now.

How would I remove the second name? I want to look at the list of sensors, etc and not see them all called “Tower Array Disk1 Usage” and just see them named “Array Disk1 Usage” and rely on the machine name to spot my two servers apart.

Thanks

Hi,
I’ve just recently created an unraid server I’ve noticed my system Ram continue to increase. I opened a command window and typed htop and I can see lots of ssh session taking up ram usage.

Is this correct?

I’ve removed the integration and rebooted my server and the system ram usage has stablized.

Hi everyone,

Thanks a lot for this integration—it works great! However, I’m encountering an issue: my cache disk usage is always reported as 0.0%, even though the Unraid UI shows that the SSDs in RAID 1 are around 17% used. I suspect this might be related to my Unraid setup rather than the integration itself, but I’m not sure how to further diagnose or resolve the discrepancy.

Has anyone experienced a similar issue or have any suggestions for troubleshooting this problem?

Thanks in advance!

Enable diagnostic logging on the integration and reload it. Check the logs for any warnings or errors relating to the cache drives.

Could be the integration not properly recognising mirrored pool device. Eg. cache and cache 2. I think that is how unraid labels them.

1 Like

Any plans to integrate with the API, Unraid API | Unraid Docs

1 Like

Hi Everyone,

I’m using a cyberpower UPS which is connected to my unraid server using usb.

From the integration, it seems like I should be able to see multiple stats (multiple entities?) for UPS stats, however I only see one single entity as shown below:

If I click the attribute I can see more stats, but I cant seem to find a way to setup notification (ex. when battery is low) using this entity, which only gives me “online” or “unavailable”.

Appreciate any help!

Edit: I figrured this out! I should use template to extract the attribute values…
I’m a newbie and have lots to learn!

1 Like

Thanks for sharing. I didn’t know about this. Will play around with it when I get time.

Hello, been using the integration and is working flawlessly, i ditched Glances i was using before and no regrets, it actually works better hahaha Quick question, don’t know if it’s been asked before, regarding the containers controls. Do the switches, and consequently the list of installed containers, update automatically? Cause i’ve installed new containers but can’t see them in the switch list! And if that’s not the case, how can i update it manually? Is it just a matter of removing the integration and adding it back in?

No need to re-install just reload the integration and it will create the missing switches.

1 Like

Just an update on this question, I looked at the API documentation today and doesn’t look that difficult to modify / retrofit the existing code to use the Unraid API.

Watch this space

2 Likes

Awesome look forward to testing it

This is great, but for a suggestion, I’d love to see disk temperature monitoring as well. I use HA to control fans that cool my external drive enclosure, and something that doesn’t require something running on the Unraid server such as this would be perfect for me. Is this something that you think you could possibly look at in the future?

Really glad to hear that. I just started to look into manually creating rest entities to use this API (to replace my current docker socket method). I always prefer to use an official API so it’s promising to hear you might support this.