mirror of
https://github.com/jokob-sk/NetAlertX.git
synced 2025-12-07 09:36:05 -08:00
27 lines
1.3 KiB
Markdown
Executable File
27 lines
1.3 KiB
Markdown
Executable File
## 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 |