UniFi Network Integration Setup

The UniFi Network integration connects Home Assistant to the UniFi Network application for device tracking and presence detection, bandwidth and uptime sensors, PoE and WLAN switches, and device restart controls. It is separate from the UniFi Protect integration , which handles cameras.

Before You Start

Confirm the following before you begin:

1. Your UniFi OS console is powered on and reachable on the local network.
2. You have UniFi administrator access to create a new user.

Step 1: Create a Local User Account

1. Sign in to your UniFi OS device.
2. Go to Admins & Users from the left menu.
3. Select Create New and check Admin.
4. Enable Restrict to local access only.
5. Create a username and password.
6. Set Network permissions to Full Management.
7. Save the user.

Step 2: Add the UniFi Network Integration

1. In Home Assistant, go to Settings > Devices & Services > Add Integration.
2. Search for UniFi Network and select it.
3. Enter the following details:
   • Host: hostname or IP address of your UniFi Network application
   • Username: the local user you created
   • Password: corresponding password
   • Port: defaults to 443
   • Verify SSL: keep enabled unless the console uses a self-signed certificate in a trusted environment and you understand the risk of disabling certificate verification
   • Site ID: appears only when multiple sites exist
4. Click Submit.

Step 3: Verify the Connection

Once connected, network clients and UniFi devices appear in Home Assistant. Typical entities include:

• device trackers for presence detection,
• switches for PoE ports, WLANs, and client blocking,
• sensors for bandwidth and uptime, and
• buttons for restarting devices and power cycling PoE ports.