Files
NetAlertX/front/plugins/unifi_import
jokob-sk ebeb7a07af BE: linting fixes 2
Signed-off-by: jokob-sk <jokob.sk@gmail.com>
2025-11-22 20:43:36 +11:00
..
2024-10-11 20:05:23 +11:00
2025-07-05 08:14:24 +10:00
2025-11-22 20:43:36 +11:00

Overview

A plugin allowing for importing devices from a UniFi controller. The plugin also tries to import the network map.

Usage

Specify the following settings in the Settings section of NetAlertX:

  • UNFIMP_username - Username used to log in the UNIFI controller.
  • UNFIMP_password - Password used to log in the UNIFI controller.
  • UNFIMP_host - Host URL or IP address where the UNIFI controller is hosted (excluding http://)
  • UNFIMP_sites - Name of the sites (usually 'default', check the URL in your UniFi controller UI if unsure. The site id is in the following part of the URL: https://192.168.1.1:8443/manage/site/this-is-the-site-id/settings/).
  • UNFIMP_protocol - https:// or http://
  • UNFIMP_port - Usually 8443, 8843, or 443
  • UNFIMP_version - see below table for details

Config overview

Controller UNFIMP_version UNFIMP_port
Cloud Gateway Ultra / UCK cloudkey V2 plus (v4.0.18) UDMP-unifiOS 443
Docker hosted v5 8443 (usually)

Notes

  • It is recommended to create a read-only user in your UniFi controller