Files
NetAlertX/server/plugins/unifi_import
Jokob @NetAlertX 9e38cfd8b4 Add website monitoring plugin and update workflows configuration
- Introduced a new plugin for monitoring website health, including functionality to check URLs and log results.
- Created README and configuration files for the workflows plugin, detailing its purpose and settings.
- Updated import paths in various test files to reflect the new directory structure.
- Ensured compatibility of test cases with the updated plugin architecture.
2026-08-10 02:32:49 +00: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 (UPSTREAM BUG: Setting UNFIMP_version='UDMP-unifiOS' will force 443 see #1524 or switch to the UNIFIAPI plugin)
  • 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 (BUG: always forced)
Docker hosted v5 8443 (usually)

Notes

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