This is a custom Home Assistant integration to support Unifi Connect devices (e.g., SE 21) using the UniFi Connect Flow SDK API.
This integration does not support UniFi accounts with 2FA or cloud-only login.
To use this integration:
- You must create a local UniFi OS account on your console (e.g., Dream Machine Pro).
- Go to your UniFi Console:
Settings→Admin Settings→Accounts- Click Add User
- Select Local Access Only
- Assign the user Full Management privileges to UniFi Connect
- Use this local user account for login in the integration setup.
- Local polling for UniFi Connect devices
- Support for Unifi Connect SE 21, including:
- Power control
- Brightness control
- Volume control
- Mode switching (Web, App) with URL selection, App Selection
- Other settings like reload, sleep, etc...
- In Home Assistant, go to HACS > Integrations.
- Click ⋮ > Custom repositories.
- Add:
- Repository:
https://github.com/iamslan/ha-unifi-connect - Category: Integration
- Repository:
- Click Add, then search for Unifi Connect and install.
- Download this repository and extract it.
- Copy the
unifi_connectfolder tocustom_components/in your Home Assistant configuration directory. - Restart Home Assistant.
- Go to Settings > Devices & Services > Integrations.
- Click Add Integration and search for Unifi Connect.
- Enter your UniFi Console IP address (e.g., Dream Machine Pro), username, and password.
- Complete the configuration flow.
This integration uses local polling and does not require cloud access.
- Make sure your UniFi OS version is up-to-date.
- Ensure your Home Assistant instance can reach your UniFi Console on the local network.
- Check logs in Settings > System > Logs for integration errors.
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
This project is licensed under the MIT License.
Maintainer: @iamslan