Skip to main content
UniFi Network supplies device role, model, IP address, reachability, firmware, available-update and uplink observations. Choose how Alignr will reach the console before preparing credentials.

​
Choose the connection mode

The two keys are different. A cloud key is not interchangeable with a console-local key. If both console fields are filled, Console ID wins and the local URL is ignored. Use UniFi’s Network API getting-started documentation to prepare a key for the intended environment. Review the API support of your installed Network version.

​
Configure Alignr

1

Prepare the account and console identity

For remote access, obtain the cloud host ID from the console URL or the cloud hosts API. Preserve the full ID. For local access, confirm the console management URL is reachable from the Alignr deployment.https://unifi.ui.com is the cloud portal, not a local console URL.
2

Add the connection

Open Integrations, add UniFi Network, and choose a descriptive Connection name. Enter API key and the one console field for your chosen mode. Review the saved connection outcome.
3

Assign the sites

Open Clients & sites, select Refresh sites, then assign each site to its intended client. UniFi site IDs are the mapping identifiers in both modes; the console itself can contain several clients’ sites.
4

Collect and inspect

Select Sync now, inspect Sync history, and check one mapped client’s device observations. Compare the device, source and observation time before running a standard.
The connection authenticates a console; the site mapping decides which client receives each site’s evidence.

​
Common setup problems

​
What this source does not prove

A device being online does not prove its security configuration is acceptable. An available firmware update does not establish whether an upgrade is safe to apply. UniFi does not supply the RMM-management predicate; a missing RMM observation is not fixed by reconnecting UniFi. Checkpoint: the correct mode authenticates, each relevant site is mapped deliberately, and one client’s current device observations match its environment. Maintain this connection or choose network controls.