[Custom Integration] UniFi Drive/UNAS for Home Assistant – local API monitoring and controls

UniFi Drive / UNAS for Home Assistant – v0.8.2

I’d like to share the current state of my custom Home Assistant integration for UniFi Drive / UNAS.

Repository:

The integration uses the local UniFi / Drive API and provides local monitoring, diagnostics, Wake-on-LAN and optional local controls.

Main features

  • Storage capacity, usage, pool status and drive health
  • Drive temperatures, power-on hours and throughput
  • UniFi OS and UniFi Drive version sensors
  • System status, uptime, IP address and CPU temperature
  • Wake-on-LAN
  • Restart / shutdown buttons
  • Fan mode select
  • Update entities
  • Backup task buttons where supported
  • Optional snapshot controls and snapshot inventory

Snapshot support

Snapshot controls are optional and disabled by default.

When enabled, the integration can expose per-target snapshot settings, including enable/disable, retention limit, schedule, schedule time, inventory count and manual snapshot creation where supported.

Snapshot inventory is read-only. Snapshot settings and snapshot creation remain experimental because they depend on local UniFi Drive endpoints, firmware version and permissions.

Discovery

Recent releases added automatic UNAS discovery.

The setup flow can discover UniFi Drive / UNAS devices, prefill connection defaults and reduce duplicate discovery prompts using host, IPv6, MAC and zeroconf identity handling.

Manual setup is still available.

There is also an optional companion dashboard card:

Unifi Drive / UNAS Card: GitHub - memphi2/ha-unifi-drive-card: Mushroom-style Lovelace card for the UniFi Drive / UNAS Home Assistant integration · GitHub

Current maturity

Area Status
Core monitoring mature beta / close to stable
Discovery hardened beta
Snapshot inventory solid beta
Snapshot controls experimental beta
Fan / backup / update controls experimental / firmware- and permission-dependent

The stable core is monitoring. Advanced controls use local UniFi OS / UniFi Drive endpoints and may vary by firmware, model and account/API-key permissions.

Not included

Destructive snapshot actions such as snapshot delete or restore are intentionally not included.

Feedback wanted

Feedback is welcome, especially for different UNAS models and firmware versions.

Useful feedback includes discovery behavior, sensor mapping, snapshot target detection, snapshot inventory status, fan/backup/update availability and diagnostics output.

Installation via HACS custom repository:

Category: Integration

1 Like

UniFi Drive / UNAS Integration – v0.3.0 Snapshot Controls Release

Update: v0.3.8 is now available

Updated to 0.4.7.

Have fun!

0.8.0 was just released. I'm sorry but you have to remove older versions before upgarding to 0.8.0.

Regards, Olli