UniFi Discovery
The UniFi Discovery integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] scans the local network for UniFi devices using the UniFi Discovery protocol. Discovered devices are automatically forwarded to their respective integrations, such as UniFi Access, UniFi Network, and UniFi Protect, for setup. Discovered integrations will show up in the discovered section on the integrations page in the configuration panel.
This is a system integration that runs in the background. It does not create any entities itself, but acts as a central discovery provider for UniFi-based integrations.
How discovery works
When Home Assistant starts, this integration begins scanning the local network for UniFi devices using the UniFi discovery protocol, similar to how the UniFi Network app finds devices. This scan repeats every 60 minutes. Additionally, the integration listens for devices joining the network through DHCP (using known Ubiquiti MAC address prefixes) and SSDP (UPnP announcements from UniFi consoles).
When a device is found, the integration checks the device’s advertised services and creates a discovery flow for the matching Home Assistant integration. For example, a device running UniFi Protect triggers a discovery flow for the UniFi Protect integration.
Configuration
This integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] is by default enabled, unless you’ve disabled or removed the default_config: line from your configuration. If that is the case, the following example shows you how to enable this integration manually:
# Example configuration.yaml entry
unifi_discovery:
Discovered integrations
The following integrations are automatically discovered by the UniFi Discovery integration: