--- title: "UGREEN NAS" description: "UGREEN NAS is a Marketplace integration for Home Assistant. It has 1.5k installs sharing analytics, works locally and was last updated October 24, 2026." canonical: "https://vulpo.app/integrations/marketplace/tom-bom-badil-home-assistant-ugreen-nas" url: "https://vulpo.app/integrations/marketplace/tom-bom-badil-home-assistant-ugreen-nas.md" last-updated: "2026-10-22" version: "1.4" --- # UGREEN NAS > UGREEN NAS is a Marketplace integration for Home Assistant. It has 1.5k installs sharing analytics, works locally and was last updated October 24, 2026. UGREEN NAS is a local integration that monitors settings and operational data of UGOS-based UGreen network attached storage devices. It reads data from the API that UGOS already provides, the same one used by its web interface and apps, so nothing extra is installed on the NAS and no SSH access is needed. It adds buttons, selects, sensors and text entities to Home Assistant. Home Assistant can discover the NAS on the network and offer to add it, and setup is done in the UI with the NAS address, port, admin login and an optional HTTPS connection. Accounts with two-factor authentication are supported by registering Home Assistant as a trusted device with a single authenticator code. Advanced options set the polling intervals for frequently and less frequently changing values, the keepalive ping rate, and the layout of a ready-made example dashboard. Automatic summary of the README and code of Tom-Bom-badil/home-assistant\_ugreen-nas. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=Tom-Bom-badil&repository=home-assistant_ugreen-nas&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=Tom-Bom-badil&repository=home-assistant_ugreen-nas&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Found by itself**: Home Assistant spots it on the network and offers to add it. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Set up UGREEN NAS - **IP address or hostname**: The IP address or hostname of your UGREEN NAS (e.g. 192.168.1.100). - **Port**: Port used for the connection (default: 9999 for HTTP, 9443 for HTTPS). - **Admin username**: Your NAS admin username. - **Admin password**: Your NAS admin password (no special characters – UGOS bug!). - **Unique device name (default: UGREEN NAS)**: Must start with a letter; then letters, numbers, and spaces are allowed. - **Use HTTPS**: Use HTTPS for the connection. - **Account uses two-factor authentication (2FA)**: Tick this only if the NAS account above has 2FA enabled. You will be asked for one code on the next screen, used to register Home Assistant as a trusted device so it never needs a code again. ### Register Home Assistant as a trusted device - **Authenticator code**: The current 6-digit code from your authenticator app. Codes expire quickly, so submit promptly. ### After setup - **IP address or hostname**: The IP address or hostname of your UGREEN NAS. - **Port**: Port used for the connection (default: 9999 for HTTP, 9443 for HTTPS). - **Admin username**: Your NAS admin username. - **Admin password**: Your NAS admin password (no special characters – UGOS bug!). - **Unique device name (default: UGREEN NAS)**: Must start with a letter; then letters, numbers, and spaces are allowed. - **Use HTTPS**: Use an encrypted HTTPS connection (requires HTTPS port). - **Register a two-factor (2FA) trusted device**: Leave unticked for normal changes. Tick it and save only if the NAS account uses 2FA and Home Assistant is not registered yet, or you need to register again. You will be asked for one code on the next screen. - **Polling interval for state entities (5s)**: How often should frequently changing values be polled? - **Polling interval for configuration entities (60s)**: How often should less frequently changing values be polled? - **Keepalive API pings (20s)**: How often should an API keepalive ping be sent via WebSocket? - **\[Example Dashboard\] Max disk columns per row (5)**: Number of disk tiles for this NAS to be shown side by side on the dashboard. - **\[Example Dashboard\] Max pool columns per row (2)**: Number of pool tiles for this NAS to be shown side by side on the dashboard. - **\[Example Dashboard\] Max volume columns per row (2)**: Number of volume tiles for this NAS to be shown side by side on the dashboard. - **\[Example Dashboard\] Image file name (default\_picture.png)**: Individual dashboard image file for this NAS in the www/community/ugreen/ folder. - **Authenticator code**: The current 6-digit code. Codes expire quickly, so submit promptly. Texts from the code of [Tom-Bom-badil/home-assistant\_ugreen-nas](https://github.com/Tom-Bom-badil/home-assistant_ugreen-nas). ## At a glance - Kind: Marketplace integration - Category: [Computers and network](https://vulpo.app/integrations/category/computers-and-network.md), NAS and servers - Number: 1.5k installs sharing analytics; 270 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v2026.10.1, last updated October 24, 2026 - Domain: `ugreen` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/0428b837b317fe51.webp (from Tom-Bom-badil/home-assistant\_ugreen-nas's README) In Vulpo: Button card, Select card, Chart card, Apple Watch Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/marketplace/tom-bom-badil-home-assistant-ugreen-nas --- - HTML version of this page: https://vulpo.app/integrations/marketplace/tom-bom-badil-home-assistant-ugreen-nas - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml