Ubiquiti UniFi

This document provides the steps required to configure the Ubiquiti Unifi Inspector.


Quick Details

Recommended Agent: On-Demand
Supported Agents: On-Demand, On-Premises, or Self-Hosted
Is Auto-Discovered By: N/A
Can Auto-Discover: UniFi Child Inspectors
Parent/Child Type Inspector: Yes
Inspection via: API
Data Summary: Here


See it in Action


UniFi Cloud Access Portal

This Inspector does not support the UniFi Cloud Access Portal. If you are interested in this, please vote for this idea.


UniFi Cloud Keys

If you are using UniFi Cloud Keys and want to deploy the UniFi Inspector, you must configure the Inspector with an On-Premises Agent or a Self-Hosted Agent. If you are using UniFi Cloud Keys, the Inspector will fail if you configure the Inspector using the On-Demand Agent.

Video isn't playing? Click here.

Inspector Setup Preparation


Read-Only Permissions

The UniFi Inspector requires a UniFi Controller login with at least Read-Only Permissions to all sites on the controller.

The exact process for preparing your UniFi controller may vary depending on your Ubiquiti device and firmware version. Please use the process that most closely resembles the options available on your UniFi controller.

For Older Ubiquiti Devices and Virtual Controllers

  1. On your UniFi Controller, navigate to Settings > Admin
  2. Create a new Admin with the "Read Only" role and select the, "Allow read only access to all sites" option.

For Newer Ubiquiti Devices (i.e. The Dream Machine Pro and Cloud Key Gen2)

  1. On your UniFi Controller, navigate to the Users screen and click Add User
  2. Create a new user with the "Viewer" Role and the "Local Access Only" Account Type

Liongard Inspector Setup

Step 1: Parent Inspector Setup


Network Access

The Liongard Agent that you use for this Inspector must be able to reach the UniFi Controller in question. If the UniFi controller you are managing is installed on-premises, this Inspector can be run through an On-Premises or Self-Hosted Agent.

Since Ubiquiti UniFi is a multi-tenant system where a single portal is used to manage many Environments, you will set up a single "Parent" Inspector with read-only permissions login that will then auto-discover "Child" Inspectors for each Environment.

In Liongard, navigate to Admin > Inspectors > Navigate to the Ubiquiti UniFi Inspector > Add System.

Fill in the following information:

  • Type of Inspector: Parent
  • Environment: Select your MSP's Environment
  • Friendly Name: Suggested Naming: [MSP Name] Ubiquiti UniFi Parent
  • Agent:Select On-Demand Agent
  • Inspector Version: Latest
  • IP Address: The fully qualified domain name or IP Address of the UniFi Controller.
  • Port: The network port on which the UniFi Controller is listening.
  • Username: The read-only username set up earlier.
  • Password: The password for the account created earlier.
  • Scheduling: The Inspector will default to run once a day at the time the Inspector is set up. Here you can adjust the schedule

Select Save. The Inspector will now be triggered to run within the minute.

Step 2: Child Inspector Setup

After the first run of the Parent Inspector, your client Ubiquiti UniFi organizations will be Auto-Discovered in the Discovered Systems tab on the Inspectors > Ubiquiti UniFi page.

Navigate to the Discovered Systems tab in your Inspectors > Ubiquiti UniFi page

  • Activate or Archive your Discovered Systems by ensuring that they're mapped to the correct Environment > Check the checkbox to the left of Inspector(s) > Select the Actions drop down menu > Activate Launchpoints

If Child Inspectors are not auto-discovered, this likely indicates that the Environment in the Ubiquiti UniFi portal does not have any child sites configured in addition to the standard default site. If this condition exists, child inspectors will need to be manually created.

Fill in the following information:

  • Type of Inspector: Child
  • Parent: Select the parent Inspector previously created
  • Environment: Select the designated Environment
  • Friendly Name: Suggested Naming: [Environment Name] Ubiquiti UniFi Child
  • Agent:Automatically populated after selecting Parent field
  • Inspector Version: Latest
  • Site Name: Enter: Default
  • Scheduling: The Inspector will default to run once a day at the time the Inspector is set up. Here you can adjust the schedule

Optional: Turn on Flexible Asset/Configuration Auto-Updating

If you would like this Inspector's data to be sent to ConnectWise and/or IT Glue, turn on Flexible Assets/Configurations for this Inspector:

  • ConnectWise: Admin > Integrations > ConnectWise > Configuration Types > Confirm the "Configuration Auto-Updating" toggle is enabled
  • IT Glue: Admin > Integrations > IT Glue > Flexible Assets > Confirm the "Flexible Asset Auto-Updating" toggle is enabled

Inspector FAQs