Homarr
Unifi Controller logo

Unifi Controller

Network controller

Unifi Controller is a network management platform for Unifi devices.

This integration is using the node-unifi library under the hood to connect to the Unifi Controller. Therefore it should support CloudKey Gen1, CloudKey Gen2, UnifiOS-based UDM-Pro controllers as well as self-hosted UniFi controllers.

Widgets & Capabilities

Network Controller SummaryDisplays the summary of a Network Controller
View guide
Network StatusDisplay connected devices on a network
View guide

Adding the integration

Create the connection under Management → Integrations. See Managing integrations.

Use the local HTTPS address of your controller:

  • UniFi OS consoles such as Dream Router, Dream Machine, Cloud Gateway, and CloudKey use https://<host> (port 443).
  • Self-hosted UniFi Network Servers normally use https://<host>:8443.
  • If you omit the port, Homarr tries port 443 first and then port 8443 when the first port cannot be reached.

Use a local administrator account. Cloud-only accounts and accounts with multi-factor authentication are not supported by the underlying client.

Secrets

NameDescription
Username
Account username for authentication.
Password
Account password for authentication.

On this page