Ubiquiti

UniFi Network

unifi

Built inLocal push

UniFi Network by Ubiquiti Networks, inc. is a software that binds gateways, switches and wireless access points together with one graphical front end.

Documentation Source code

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.

Entity	Shows up as	Note
`light`	Light
`switch`	Switch or outlet
`sensor`	Sensor (temperature)
`button`	Button (as a switch)
`device_tracker`	Presence (as an occupancy sensor)

What people report

UniFi Network works locally with a local admin user; cloud SSO and MFA accounts, and Early Access releases, cause login failures.

Works2
Partly works3
Won’t be supported1

Device	In Home Assistant	What they said	Source
UniFi network devices temperature sensors	Works Local	Device temperature sensors added Saved copy Breaking change Only additive features ## Proposed change <!-- Describe the big picture of your changes here to communicate to the maintainers why we should accept this pull request. If it fixe Excerpt saved from GitHub on 2026-10-23.	PR #122518 · 2024-07
UniFi PoE switch ports	Works Local	PoE and port control switches supported Saved copy Breaking change N/A - This is not a breaking change. ## Proposed change <!-- Describe the big picture of your changes here to communicate to the maintainers why we should accept this pull req Excerpt saved from GitHub on 2026-10-23.	PR #150152 · 2025-08
UniFi Cloud Gateway Max	Partly works Local	Login failures; needs local user, SSO cloud accounts unsupported Saved copy … what I do, I always get an error. http://, https://, port 80, 443, 420 aso.... I've already created new and different users several times, restarted the Unifi Cloud Gateway Max several times, and removed all the integrations in HA, but nothing helps me log in. I cant also login to Unifi Protect at the same time as Network was down. ### What version of Home Assistant Core has the issue? 2025.9.3 ### What was the last working version of Home Assistant Core? 2025.7.3 ### What type of installation are you running? Home Assistant Container ### Integration causing the issue Ubiquiti Unifi Network … Excerpt saved from GitHub on 2026-10-23.	Issue #152502 · 2025-09
UniFi Network add-on controller	Partly works Local	All entities go unavailable around 3am nightly until reload Saved copy The problem I recently noticed that all of the entities provided by the Unifi integration are unavailable around 3am every night. The problem persists until I reload the integration. Here are the logs: ----------------------------------------------------------- Add-on: UniFi Network Application Manage your UniFi network using a web browser ----------------------------------------------------------- Add-on version: 3.0.5 You are running the latest version of this add-on. System: Home Assistant OS 12.2 (aarch64 / raspberrypi4-64) Home Assistant Core: 2024.3.3 Home Assistant Supervisor: … Excerpt saved from GitHub on 2026-10-23.	Issue #117976 · 2024-05
UniFi UDM Pro / UCG with MFA	Partly works Local	Integration login broke after MFA enforcement; local non-cloud user required Saved copy The problem Unifi forced me to enable 2 factor authentication to unifi controller. I think integration doesn't work anymore and it is unable to login. After using "reconfigure" option i receive "Invalid authentication" message. Also i receive "MFA Login Authentication Use this code to authenticate your Ubiquiti SSO login attempt." email. But there is no way to enter code to HA login dialog. Reopening #121322 because it is still problem and was NOT resolved. Further information for @Kane610 1) I think you missed point about MFA. MFA is 2 factor auth for LOCAL account it is NOT cloud account. … Excerpt saved from GitHub on 2026-10-23.	Issue #121935 · 2024-07
UniFi OS 4.0.3 Early Access	Won’t be supported Local	EA releases unsupported; broke Network and Protect Saved copy Early access is unsupported territory so this is always the risk. > > Do you run a local account or cloud account? If you enable debug logs do you see any more information? Agree about early access, but this is preparaion to udm pro max migration coming tomorrow... i'm running local account. this what it shows in debug ```2024-04-29 20:57:26.784 INFO (MainThread) [homeassistant.components.unifi] Will try to reconnect to UniFi Network 2024-04-29 20:57:26.784 DEBUG (MainThread) [aiounifi.interfaces.connectivity] sending (to https://192.168.1.1:443) get, None, {'allow_redirects': False} … Excerpt saved from GitHub on 2026-10-23.	Issue #116411 · 2024-04

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)	42,499 (6.0%)
Quality scale	Silver
Added in	Home Assistant 0.81
Set up in the UI	Yes
Maintainers	@Kane610

Limitations from the docs

Ubiquiti SSO cloud users are not supported. You must create a local user in your UniFi OS Console. See the Local user section for instructions.
Early Access and Release Candidate versions of UniFi Network and UniFi OS are not supported. Only the official Stable Release channel is expected to work with this integration.
Presence detection is not compatible with MAC Address Randomization, which is enabled by default on most modern smartphones. This feature must be disabled per network on the client device.
Changes to LED control on access points may take over 5 seconds to apply because the device must adopt a new configuration first.
Lingering entities: In some edge cases, clients or devices removed from UniFi Network may remain in the Home Assistant device registry and need to be removed manually.

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.