home-assistant.io/source/_integrations/unifi.markdown

title, description, ha_category, ha_release, ha_iot_class, ha_config_flow, ha_quality_scale, ha_codeowners, ha_domain, ha_ssdp, ha_platforms

title	description	ha_category	ha_release	ha_iot_class	ha_config_flow	ha_quality_scale	ha_codeowners	ha_domain	ha_ssdp	ha_platforms
Ubiquiti UniFi	Instructions on how to configure UniFi integration with UniFi Controller by Ubiquiti.	Hub Presence Detection Switch Sensor	0.81	Local Push	true	platinum	@Kane610	unifi	true	device_tracker sensor switch

UniFi by Ubiquiti Networks, inc. is a software that binds gateways, switches and wireless access points together with one graphical front end.

There is currently support for the following device types within Home Assistant:

• Presence Detection
• Switch
• Sensor

{% include integrations/config_flow.md %}

The user needs administrator privileges in order to control switches.

Extra configuration of the integration

All configuration options are offered from the front end. Enter what UniFi integration you want to change options on and press the cog wheel. Some advanced options are available when "Advanced Mode" is enabled on your user profile page.

Configuring Users

The UniFi controller allows you to create multiple users on it besides the main administrator. If all you want to use is the device tracker then it is recommended that you create a limited user that has read-only permissions for the UniFi device tracker. If you want blocking of network access or POE control as well you would need to have 'admin' permissions.

UniFi OS

For UniFi OS a local-only user needs to be created. A user who uses the Ubiquiti cloud will not work. You can do this in the manage users section on the UniFi OS dashboard. Make sure to give it the right permissions for the functions you want to use. Note the Dream Machine Pro and Cloud Key Gen2 plus updated to UniFi OS needs the port to be 443.

Conflicts with MQTT

The UniFi controller can either be a dedicated hardware device (UniFi's cloud key), or as software on any Linux system. If you run the UniFi controller on the same operating system as Home Assistant there may be conflicts in ports if you have the MQTT integration as well.

It is recommended that you run the UniFi controller in a dedicated virtual machine to avoid that situation.

Presence detection

This platform allows you to detect presence by looking at devices connected to a Ubiquiti UniFi controller. By default devices are marked as away 300 seconds after they were last seen.

Troubleshooting and Time Synchronization

Presence detection depends on accurate time configuration between Home Assistant and the UniFi controller.

If Home Assistant and the UniFi controller are running on separate machines or VMs ensure that all clocks are synchronized. Failing to have synchronized clocks will lead to Home Assistant failing to mark a device as home.

Related Issue

Services

Service unifi.reconnect_client

Try to get a wireless client to reconnect to the network.

Service data attribute	Optional	Description
device_id	No	String representing a device ID related to a UniFi integration.

Service unifi.remove_clients

Clean up clients on the UniFi Controller that has only been associated with the controller for a short period of time. The difference between first seen and last seen needs to be less than 15 minutes and the client can not have a fixed IP, hostname or name associated with it.

Switch

Block network access for clients

Allow control of network access to clients configured in the integration options by adding MAC addresses. Items in this list will have a Home Assistant switch created, using the UniFi Device name, allowing for blocking and unblocking.

Control clients powered by POE

Entities appear automatically for each connected POE client. If no POE client device is in operation, no entity will be visible. Note: UniFi infrastructure devices such as access points and other switches are not (yet) supported, even if they are powered over ethernet themselves.

Note that POE control actually configures the network port of the switch which the client is connected to.

Control DPI Traffic Restrictions

Entities appear automatically for each restriction group. If there are no restrictions in a group, no entity will be visible. Toggling the switch in Home Assistant will enable or disable all restrictions inside a group.

Sensor

Bandwidth sensor

Get entities reporting receiving and transmitting bandwidth per network client.

Uptime sensor

Get entities reporting uptime per network client.

Debugging integration

If you have problems with UniFi or the integration you can add debug prints to the log.

logger:
  default: info
  logs:
    aiounifi: debug
    homeassistant.components.unifi: debug
    homeassistant.components.device_tracker.unifi: debug
    homeassistant.components.switch.unifi: debug