UniFi AP

This integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to detect presence by looking at devices connected to a UniFi AP. This device tracker differs from Ubiquiti UniFi because it doesn’t require the UniFi Network application.

Prerequisites

To set up the integration, you need the following:

• The IP address of your UniFi AP.
• The SSH device username and password. You can set this in the UniFi Network application under Device Updates and Settings > Device SSH Settings.

Configuration

To add the UniFi AP device to your Home Assistant instance, use this My button:

Migrating from YAML configuration

If you previously configured the integration through configuration.yaml:

1. Set up the integration through the UI to provide your credentials.
2. Remove the unifi_direct entry under device_tracker: from your configuration.yaml file.
3. Restart Home Assistant.

A repair issue in Settings > Devices & services will guide you through the same steps.

Supported functionality

The integration creates a device trackerDevice trackers are used to track the presence, or location, of a device. [Learn more] entity for each device known to your UniFi AP. You can use these entities to track the presence of people in your home. For more information on how to assign tracked devices to people, see the device tracker integration page.

Data updates

Home Assistant pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] your UniFi AP every 30 seconds to retrieve the list of connected devices and update their connection status.

Troubleshooting

If the setup fails or the integration stops working, check the following:

• Make sure the IP address of your UniFi AP is correct and reachable from Home Assistant.
• Make sure the SSH device username and password are correct. The integration signs in to your UniFi AP over SSH to read the list of connected devices, so it needs valid credentials.

Removing the integration

This integration follows standard integration removal.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.