---
title: "UniFi UNAS"
description: "UniFi UNAS is a Marketplace integration for Home Assistant. Its installs are not shown, because another integration uses the same domain, unifi_unas. It works locally and was last updated October 18, 2026."
canonical: "https://vulpo.app/integrations/marketplace/cardouken-homeassistant-unifi-unas"
url: "https://vulpo.app/integrations/marketplace/cardouken-homeassistant-unifi-unas.md"
last-updated: "2026-10-22"
version: "1.4"
---

# UniFi UNAS

> UniFi UNAS is a Marketplace integration for Home Assistant. Its installs are not shown, because another integration uses the same domain, unifi\_unas. It works locally and was last updated October 18, 2026.

UniFi UNAS is an integration for monitoring and fan control of Ubiquiti UniFi UNAS network storage devices. It runs locally, connecting over SSH and publishing data through an MQTT broker, and it is set up in the UI. Sensors cover system metrics, HDD and NVMe drive health, storage pools, network shares and backup tasks. Fan control offers four modes: UNAS managed, custom curve, target temperature and set speed, with adjustable temperature and fan speed limits. Buttons can reinstall the monitoring scripts, reboot or shut down the device, and trigger backups, while switches enable or disable scheduled backup tasks. Repair notices appear for a missing MQTT integration, a lost SSH connection or a changed SSH host key.

Automatic summary of the README and code of cardouken/homeassistant-unifi-unas. 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=cardouken&repository=homeassistant-unifi-unas&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=cardouken&repository=homeassistant-unifi-unas&category=integration)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **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.

### Connect to UniFi UNAS

- **Host (UNAS IP Address)**
- **UNAS SSH username (root by default)**
- **UNAS SSH password (Leave blank if HA SSH keys are configured on the UNAS)**
- **MQTT Broker IP Address**
- **MQTT Username (required)**
- **MQTT Password (required)**
- **Use TLS**: Only enable if your MQTT broker is configured for TLS (port 8883). Leave off for standard setups.
- **Device Model**
- **Device Name**: Optional custom name (e.g. UNAS Pro Hallway) - will be used for entity ID-s, e.g.: sensor.unas\_pro\_hallway\_cpu\_temperature
- **Verify SSH host key**: Verify the NAS SSH host key. On the first connection the key is recorded (trust-on-first-use) and checked on every connection after that. Leave off to keep the current permissive behavior.
- **Polling Interval (seconds, 5-60)**

### MQTT TLS Settings

- **MQTT Broker Port**
- **Allow untrusted certificate**: Enable if your MQTT broker uses a self-signed certificate.

Also asked when changing the connection.

### Reconfigure UniFi UNAS

- **Host (UNAS IP Address)**
- **UNAS SSH username (root by default)**
- **UNAS SSH password (Leave blank if HA SSH keys are configured on the UNAS)**
- **MQTT Broker IP Address**
- **MQTT Username (required)**
- **MQTT Password (required)**
- **Use TLS**: Only enable if your MQTT broker is configured for TLS (port 8883). Leave off for standard setups.
- **Device Model**: WARNING: Changing the device model requires deleting and re-adding the integration to update drive entities.
- **Device Name**: Changes device display names only. Entity IDs are set at initial setup and cannot be changed here.
- **Verify SSH host key**: Verify the NAS SSH host key. On the first connection the key is recorded (trust-on-first-use) and checked on every connection after that. Leave off to keep the current permissive behavior.
- **Polling Interval (seconds, 5-60)**

### After setup

- **Polling Interval (seconds, 5-60)**

Texts from the code of [cardouken/homeassistant-unifi-unas](https://github.com/cardouken/homeassistant-unifi-unas).

## Troubleshooting

- **Repair notices**: Notices it can show in Settings, Repairs:
  MQTT Integration Required, Multiple devices publishing to the same MQTT topic, UNAS SSH connection unavailable, UniFi UNAS SSH host key changed

## From the README

> Monitoring and fan control for UniFi UNAS with native Home Assistant integration.
>
> - One-Click Setup - Automatic script deployment via SSH
> - Full Monitoring - 40+ sensors for drives, system metrics, storage pools, and network shares
> - Fan Control - Three modes with custom temperature curves
> - Auto-Recovery - Scripts redeploy automatically on integration updates or if missing after firmware updates
> - Native Integration - Proper HA devices and entities with MQTT discovery

From the README of [cardouken/homeassistant-unifi-unas](https://github.com/cardouken/homeassistant-unifi-unas#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [Computers and network](https://vulpo.app/integrations/category/computers-and-network.md), Routers and network
- Brand: [Ubiquiti](https://vulpo.app/integrations/ubiquiti.md)
- Number: Installs not shown: shared domain unifi\_unas; 58 GitHub stars
- Connection: Works locally
- Upkeep: Updated in the last 6 months
- Needs: Needs the Marketplace (HACS on 2026.10 and older)
- Latest version: v0.9.7, last updated October 18, 2026
- Domain: `unifi_unas`
- Source: <https://github.com/cardouken/homeassistant-unifi-unas>
- Issues: <https://github.com/cardouken/homeassistant-unifi-unas/issues>
- Screenshot: https://vulpo.app/integrations-img/8ba7b5ccf92e7e06.webp (from cardouken/homeassistant-unifi-unas's README)

In Vulpo: Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center

## Other ways in for Ubiquiti

| Name | Kind | Installs or stars | Connection | Upkeep |
| --- | --- | --- | --- | --- |
| [UniFi Network](https://vulpo.app/integrations/core/unifi.md) | Built-in integration | 42.8k installs sharing analytics | Works locally | Part of Home Assistant |
| [UniFi Protect](https://vulpo.app/integrations/core/unifiprotect.md) | Built-in integration | 25.6k installs sharing analytics | Works locally | Part of Home Assistant |
| [UniFi Access](https://vulpo.app/integrations/core/unifi-access.md) | Built-in integration | 1.6k installs sharing analytics | Works locally | Part of Home Assistant |
| [Unifi Access](https://vulpo.app/integrations/marketplace/imhotep-hass-unifi-access.md) | Marketplace integration | 693 installs sharing analytics | Works locally | Updated in the last 6 months |
| [UniFi Network Map](https://vulpo.app/integrations/marketplace/merlijntishauser-unifi-network-maps-ha.md) | Marketplace integration | 503 installs sharing analytics | Works locally | Updated in the last 6 months |

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/cardouken-homeassistant-unifi-unas

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/cardouken-homeassistant-unifi-unas
- 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
