Skip to content

zacharee/ha-unifi-connect

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Unifi Connect for Home Assistant

hacs_badge GitHub

This is a custom Home Assistant integration to support Unifi Connect devices (e.g., SE 21) using the UniFi Connect Flow SDK API.

⚠️ Notice

This integration does not support UniFi accounts with 2FA or cloud-only login.

To use this integration:

  1. You must create a local UniFi OS account on your console (e.g., Dream Machine Pro).
  2. Go to your UniFi Console:
    • SettingsAdmin SettingsAccounts
    • Click Add User
    • Select Local Access Only
    • Assign the user Full Management privileges to UniFi Connect
  3. Use this local user account for login in the integration setup.

Features

  • 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...

Installation

HACS (Recommended)

  1. In Home Assistant, go to HACS > Integrations.
  2. Click ⋮ > Custom repositories.
  3. Add:
    • Repository: https://github.com/iamslan/ha-unifi-connect
    • Category: Integration
  4. Click Add, then search for Unifi Connect and install.

Manual

  1. Download this repository and extract it.
  2. Copy the unifi_connect folder to custom_components/ in your Home Assistant configuration directory.
  3. Restart Home Assistant.

Configuration

  1. Go to Settings > Devices & Services > Integrations.
  2. Click Add Integration and search for Unifi Connect.
  3. Enter your UniFi Console IP address (e.g., Dream Machine Pro), username, and password.
  4. Complete the configuration flow.

This integration uses local polling and does not require cloud access.

Troubleshooting

  • 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.

Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

License

This project is licensed under the MIT License.


Maintainer: @iamslan

About

HomeAssistant integration for Unifi Connect

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%