Skip to content
Home Assistant TestFlight
Ubiquiti

UniFi Access

unifi_access

Built inLocal pushPlatinum

The UniFi Access integration allows you to control and monitor Ubiquiti UniFi Access devices from Home Assistant.

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

EntityShows up asNote
switchSwitch or outlet
binary_sensorSensor (contact)
buttonButton (as a switch)
selectMode picker (as switches)

What people report

UniFi Access readers, locks and hubs work locally with push updates, but doors can only be unlocked individually. Some newer devices went unavailable in spring 2026.

  • Works7
  • Partly works1
  • Not working1
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
UniFi Access HubWorks LocalListed as supported; no per-door lock command (unlock only)
Saved copy
Supported devices: UniFi Access Reader (UA Reader, UA Reader Pro, UA Reader Lite); UniFi Access Lock (UA Lock); UniFi Access Hub (UA Hub, UA Hub Ultra). Limitations: No per-door lock command: The UniFi Access API only supports unlocking individual door entities. The controller-wide lockdown emergency mode is a separate feature and can lock all doors simultaneously. Single controller: Each configuration entry connects to one UniFi Access controller. If you have multiple controllers, add a separate integration entry for each.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
UniFi Access Hub UltraWorks LocalListed as supported; no per-door lock command (unlock only)
Saved copy
Supported devices: UniFi Access Reader (UA Reader, UA Reader Pro, UA Reader Lite); UniFi Access Lock (UA Lock); UniFi Access Hub (UA Hub, UA Hub Ultra). Limitations: No per-door lock command: The UniFi Access API only supports unlocking individual door entities. The controller-wide lockdown emergency mode is a separate feature and can lock all doors simultaneously. Single controller: Each configuration entry connects to one UniFi Access controller. If you have multiple controllers, add a separate integration entry for each.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
UniFi Access LockWorks LocalListed as supported; no per-door lock command (unlock only)
Saved copy
Supported devices: UniFi Access Reader (UA Reader, UA Reader Pro, UA Reader Lite); UniFi Access Lock (UA Lock); UniFi Access Hub (UA Hub, UA Hub Ultra). Limitations: No per-door lock command: The UniFi Access API only supports unlocking individual door entities. The controller-wide lockdown emergency mode is a separate feature and can lock all doors simultaneously. Single controller: Each configuration entry connects to one UniFi Access controller. If you have multiple controllers, add a separate integration entry for each.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
UniFi Access ReaderWorks LocalListed as supported; no per-door lock command (unlock only)
Saved copy
Supported devices: UniFi Access Reader (UA Reader, UA Reader Pro, UA Reader Lite); UniFi Access Lock (UA Lock); UniFi Access Hub (UA Hub, UA Hub Ultra). Limitations: No per-door lock command: The UniFi Access API only supports unlocking individual door entities. The controller-wide lockdown emergency mode is a separate feature and can lock all doors simultaneously. Single controller: Each configuration entry connects to one UniFi Access controller. If you have multiple controllers, add a separate integration entry for each.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
UniFi Access Reader LiteWorks LocalListed as supported; no per-door lock command (unlock only)
Saved copy
Supported devices: UniFi Access Reader (UA Reader, UA Reader Pro, UA Reader Lite); UniFi Access Lock (UA Lock); UniFi Access Hub (UA Hub, UA Hub Ultra). Limitations: No per-door lock command: The UniFi Access API only supports unlocking individual door entities. The controller-wide lockdown emergency mode is a separate feature and can lock all doors simultaneously. Single controller: Each configuration entry connects to one UniFi Access controller. If you have multiple controllers, add a separate integration entry for each.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
UniFi Access Reader ProWorks LocalListed as supported; no per-door lock command (unlock only)
Saved copy
Supported devices: UniFi Access Reader (UA Reader, UA Reader Pro, UA Reader Lite); UniFi Access Lock (UA Lock); UniFi Access Hub (UA Hub, UA Hub Ultra). Limitations: No per-door lock command: The UniFi Access API only supports unlocking individual door entities. The controller-wide lockdown emergency mode is a separate feature and can lock all doors simultaneously. Single controller: Each configuration entry connects to one UniFi Access controller. If you have multiple controllers, add a separate integration entry for each.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
UniFi G6 Pro Entry readerWorks LocalFace, NFC or PIN reader triggers HA through UniFi Access; security concerns raised
Saved copy
… unlock with Face ID (with guide). # Front Door Face Unlock, Self-Hosted Guide Automatically unlock your front door using face recognition, NFC, or PIN via UniFi Access + Home Assistant + Matter over Thread. # Hardware |Component|Purpose| |:-|:-| |UniFi G6 Pro Entry|Door reader, face recognition, NFC, PIN| |UniFi Access Hub Mini|Required UniFi Access controller, powers and manages the G6 Pro via PoE++| |Eufy Smart Lock E30|Door lock actuator (Matter over Thread)| |SLZB-MR1|USB Thread radio, provides the Thread border router for HA| |Home Assistant (dedicated machine)|Automation hub, Thread …

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit thread · 2026-06
UniFi Access Intercom Viewer UA-Int-ViewerPartly works LocalWebsocket updates with null category caused validation errors; fix expected in 2026.5
Saved copy
The problem I’m seeing repeated websocket parsing failures from the UniFi Access integration in Home Assistant which I alluded to in #167128 and was finally able to chase down: [code] I was able to capture the exact offending raw websocket payload. ## What is causing the error The failing event is an `access.data.v2.device.update` from my Intercom Viewer: - `device_type`: `UA-Int-Viewer` - firmware: `1.5.30` - the payload contains: - `cap: null` - `category: null` The parser currently expects `category` to be a list for `V2DeviceUpdate`, so this raises a validation error before Home Assistant …

Excerpt saved from GitHub on 2026-10-23.

Issue #167698 · 2026-04
UniFi Access Hub and G6 Entry ProNot working LocalStill unavailable after 2026.5 upgrade
Saved copy
I don't see the same error in the core intergration, i'm not running the HACS integration version UniFi OS version = 5.0.16 Access version = 4.2.16 Hardware running Access (Cloud Key Gen2+, UDM-Pro, etc.) = UDM-SE UniFi Access Hub model and firmware version = UA Hub 4.11.19.0 at start Logger: homeassistant.components.unifi_access.coordinator Source: helpers/update_coordinator.py:598 Integration: UniFi Access (documentation, issues) First occurred: 07:05:59 (2 occurrences) Last logged: 07:06:45 Error requesting unifi_access data: WebSocket disconnected from UniFi Access and then the rest of …

Excerpt saved from GitHub on 2026-10-23.

Issue #169975 · 2026-05

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local push

Talks to the device on your network, and the device tells Home Assistant the moment something changes.

Details

Installs (analytics)1,586 (0.22%)
Quality scalePlatinum
Added inHome Assistant 2026.4
Set up in the UIYes
Maintainers@imhotep, @RaHehl

Devices listed in its documentation

  • UniFi Access Reader (UA Reader, UA Reader Pro, UA Reader Lite)
  • UniFi Access Lock (UA Lock)
  • UniFi Access Hub (UA Hub, UA Hub Ultra)

Limitations from the docs

  • No per-door lock command: The UniFi Access API only supports unlocking individual door entities. The controller-wide lockdown emergency mode is a separate feature and can lock all doors simultaneously.
  • Single controller: Each configuration entry connects to one UniFi Access controller. If you have multiple controllers, add a separate integration entry for each.

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.