[APP][Pro] Ugreen NAS - Manage your device locally from Homey!

Hi everyone! :waving_hand:

I’m excited to share the very first Ugreen NAS app for Homey. As Ugreen NAS devices are becoming more popular, I realized we needed a solid, local integration to monitor our NAS health and triggers directly within our smart home ecosystem.

After a lot of testing, I have just published v1.0.0 to the Homey App Store (currently awaiting certification / in test). Before the official release, I would love to get some feedback and testing results from the community!

:gear: What does it do?

The app connects 100% locally to your Ugreen NAS via HTTP API. Currently, it allows you to monitor vital stats and perform basic power actions:

Sensors:

  • CPU Usage (%) & Memory Usage (%)

  • Network Traffic (Download & Upload Speeds in kB/s)

  • Storage Pool Usage (%)

  • Disk Read & Write Rates (kB/s)

  • Dynamic Temperatures (for Chassis, M.2, SSD, HDD)

  • Dynamic Fan Speeds (System Fan, CPU Fan in RPM - Note: Fan modes/controls are not supported for stability reasons, it is read-only)

Actions:

  • Safe Shutdown

  • Reboot

:hammer_and_wrench: How to setup for testing?

Important Note: To allow Homey to securely access your NAS API, you must create a dedicated Local Administrator User inside your Ugreen NAS settings.

  1. Install the test version from the Homey App Store (Link below)

  2. Add a new device → Ugreen NAS

  3. Enter your NAS IP Address, Port (Default HTTP is 9999 or whatever you configured), and your newly created Local Admin Username & Password.

:link: Links

:bug: Feedback & Bugs

“The birth of Ugreen Nas application” is just the beginning! If you encounter any bugs or have feature requests, please drop a comment below. I’ll do my best to investigate. Let me know which Ugreen NAS model you are using so we can check compatibility across the DXP series.

Thanks and enjoy!

5 Likes

Ok — this is absolutely awesome. I actually own a DXP4800 Plus myself and had been desperately hoping someone would eventually come up with a Homey app for it (it was already possible on Home Assistant — until now I’d been pulling the data virtually from HA).

Thank you so, so much for this app! I’m going to try it out right away!

1 Like

:rocket: Update v1.0.2 is Live: Mobile Icon Fixes & Important Connection Tip!

Hi everyone! :waving_hand:

I’ve just published version 1.0.2 of the Ugreen NAS app to the Homey App Store. This update brings a much-needed visual fix and I also have an important tip for anyone experiencing connection issues.

:hammer_and_wrench: What’s New & Fixed in v1.0.2:

  • Fixed Mobile App Icons: Some custom capability icons (like CPU, RAM, Disk, Pool) were appearing as giant, solid white blocks on the Homey mobile app. This was a rendering issue with stroke-based SVGs on mobile devices. All icons have been replaced with proper fill-based SVGs and they now look crisp and clean on both iOS and Android! :sparkles:

:light_bulb: Important Tip regarding “fetch failed” / Connection Errors: If you are confident that your IP and Port are correct but the app still fails to connect to your Ugreen NAS (throwing a fetch failed or connection timeout error), please check your NAS settings!

A huge thanks to our community member Alex for discovering this: If you have “HTTP to HTTPS redirection” enabled under the Portal Settings on your NAS, it will instantly reject the standard HTTP connection attempt from the Homey app. :backhand_index_pointing_right: Solution: Temporarily disable the HTTP to HTTPS redirection, and the app should connect perfectly! (I’ll be looking into adding direct HTTPS support in future updates).

Really nice to see this app!!

I cannot add my DXP4800+ however. The settings are 100% correct and still I get this error.

I have firmware 1.13.1.0105 on the nas.

Hi Mike, thanks for the feedback! I noticed that UGREEN updated their API security in the newer firmware versions (1.13+), which actively blocked third-party connections with a ‘client not compatible’ error. \n\nI have rewritten the backend connection headers to bypass this firmware block and just published v1.0.3 to the Homey App Store. Once the update is live, please install it here: https://homey.app/tr-tr/app/com.ugreen.nas/Ugreen-NAS/test/ \n\nLet me know if it solves the login issue for your DXP4800+!"

Hi, the 1.0.3 version did not fixed my issue. The same error still occurs.

Hi @Mike_de_Vries,

We have just released version 1.0.7 to the Homey App Store. This update includes a fix for the ‘Client is not compatible’ error encountered on Ugreen firmware 1.13+ and significantly improves real-time sensor polling for CPU, Disks, and Fans.

Please update the app and give it another try. If you still encounter any issues, could you please send a ‘Diagnostic Report’ from within the Homey app settings? This will help us investigate the issue further.

Thank you for your feedback and patience!

Hi everyone! :waving_hand:

I have some great news to share: The Ugreen NAS app has passed the certification process and is now live on the Homey App Store! :tada:

You can download and install the app directly from here: :backhand_index_pointing_right: Ugreen NAS on Homey App Store

With this community app, you can seamlessly connect, monitor, and manage your Ugreen NAS devices locally, right from your Homey Pro. You can now easily integrate your NAS into your daily flows!

A huge thank you to everyone who has been waiting for the release. Please go ahead and give it a try!

I would love to hear your thoughts. If you encounter any bugs, have questions, or want to suggest new features, please feel free to report them right here in this thread. Also, I’d love to see how you are using the Ugreen NAS in your Homey flows!

Looking forward to your feedback! :rocket:

2 Likes

Congrats!

My issue still remains, but it was because I had 2FA enabled, and then it will NOT work :slight_smile:
so I created a new local account without 2FA and now it works!

1 Like

Hi @Mike_de_Vries,

Thank you very much for your feedback and congratulations! :blush:

I’m really glad to hear you got it working. Yes, as you discovered, the app currently doesn’t support 2FA (Two-Factor Authentication) for the local API login. Creating a dedicated local account without 2FA just for Homey is exactly the recommended and most secure approach for this kind of local integration.

This requirement is also mentioned in the app’s setup instructions and the App Store description, but it’s great that you highlighted it here in the forum as well—it might help other users who run into the same issue!

Thanks again, and enjoy using the Ugreen NAS in your flows! :rocket:

I’m finally able to connect by disabling http to https, but now it’s showing:

Device Unavailable

Cannot reach NAS: Connection failed: fetch failed - self-signed certificate
any ideas ?

Hi,

Thanks for reporting this issue! The “fetch failed - self-signed certificate” error occurs because of the strict SSL certificate verification when connecting to the NAS locally via HTTPS.

I have just released a new update (v1.0.8) that resolves this issue by allowing self-signed certificates for local connections. You can install and test the fix right now using the test version link below:

https://homey.app/en-gr/app/com.ugreen.nas/Ugreen-NAS/test/

Please let me know if it works for you or if you encounter any other issues.

I installed 1.09 and http to https is off. At first it seem like it’s connected but then when you click on the nas in homey it shows Device Unavailable

Cannot reach NAS: Failed to fetch system stats

Could you please send me a Diagnostics Report from the app so I can investigate the issue? (You can do this by going to Homey App → More (…) → Apps → Ugreen NAS → Settings → Create Diagnostics Report).

Also, could you please tell me the exact model of your Ugreen NAS device?

I will definitely look into this tomorrow and get back to you.

I have the ugreen dxp4800 plus

f0c47ae9-ce88-45d2-a688-5d65de69e125

1 Like

Thank you for the diagnostics report! The connection establishes successfully, but for some reason, your specific DX4800 firmware is rejecting the request to fetch system statistics (CPU, RAM, Disks) over the API.

Since every NAS model or firmware update can behave slightly differently, I have just published a new test version (v1.1.0) with extended diagnostics logging.

Could you please install the test version (v1.1.0) from the link below, let it run, and send me one more Diagnostics Report? Test Link: https://homey.app/en-gr/app/com.ugreen.nas/Ugreen-NAS/test/

This will log the exact reason your NAS is refusing to provide data so I can build a fix for the DX4800.

Thank you for your help

ok thanks I’ll run it tonight. Would it matter if the nas is bought in China ?

5eb590bb-d791-4e48-8505-f0743bffdbc0

With the last test provided, it connects successfully but when I use some flows actions, it happens something very weird: actions buttons keeps appearing and disappearing in loop, it is so strange, so basically I cannot use any actions because as soon as I try to grasp them from the action list they disappear. I know it sounds like crazy, but a video maybe can help! In the meantime I give you a log.

16e91c66-e123-4803-af46-99d5da6c4143

1 Like

I’m away on business right now. I’ll for sure take care of it this weekend.