UniFi Network integration for Gladys Assistant
Ubiquiti UniFi integration for UCG, UDM, Switches, APs and network presence tracking.
Published by guim31
- Devices
- Version 1.5.2
- Requires Gladys >=4.62.0
- ★ 0
Connect your Ubiquiti UniFi OS console (UCG Fiber, Dream Machine UDM/UDM-SE, UniFi Express, Cloud Key, or self-hosted UniFi Controller) to Gladys Assistant.
Features
- Network Presence Tracking (Device Tracker): Real-time tracking of smartphones and connected network devices for Gladys presence/absence scenes.
- Internet Access Control: Switch button to block or unblock internet access for any connected client device.
- Switch PoE Port Control: Turn PoE power ON/OFF on switch ports (useful for power cycling IP cameras or Access Points).
- Wi-Fi SSID Control: Enable or disable Wi-Fi networks (e.g., Guest Wi-Fi) from Gladys dashboards or scenes.
- WAN & Gateway Health Metrics: Real-time Upload/Download throughput (Mbps) and Gateway online status.
Local Authentication Guide (100% Local First)
The integration connects directly to your local UniFi console using a local admin account:
Create a dedicated local admin account in UniFi OS:
- Log into your UniFi OS console (
https://192.168.1.1orhttps://192.168.100.1). - In the left navigation bar, click Admins / Users (👥) (or under Control Plane / Identity > Admins).
- Click Add Admin.
- Select Local Access Only.
- Set a username (e.g.
gladys) and password. - Grant Admin role (required to block internet or toggle PoE ports) or Read Only.
- In Gladys, enter your console IP address, username
gladys, and local password.
Usage
- Save configuration in Gladys and click Test UniFi Connection to verify.
- Go to the Discovery tab in Gladys to import your Gateway, network clients, PoE ports, and Wi-Fi networks.
Configuration settings
These are the settings UniFi Network asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| Local UniFi Connection | section | No | Select your authentication mode and enter your local UniFi credentials or local API key. |
| IP Address / Hostname | string | Yes | IP address of your UniFi OS console (e.g. 192.168.1.1). |
| Port | number | Yes | |
| Authentication Mode | select | Yes | |
| Local API Key | secret | No | API Key generated in UniFi Network > Integrations. |
| Local Username | string | No | Local admin username created in Console > Users & Admins (required if Credentials mode selected). |
| Local Password | secret | No | |
| Site ID | string | Yes | |
| Presence Offline Delay (s) | number | No | Inactivity delay before marking a device as absent (prevents deep sleep toggling). |
| Device Discovery & Filtering | section | No | Configure which devices should be discovered and published to Gladys. |
| Discover Infrastructure (Console, APs, Switches) | boolean | No | |
| Discover Network Clients | boolean | No | |
| Only Connected Clients (Ignore historical known clients) | boolean | No | Only import currently connected clients to prevent importing hundreds of offline historical devices. |
| Client Connection Type | select | No | |
| Allowed Wi-Fi SSIDs | string | No | Filter Wi-Fi clients by SSID names (comma separated, e.g. Home, IoT). Leave empty to allow all SSIDs. |
How to install UniFi Network in Gladys
- In Gladys, open Integrations: UniFi Network appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/guim31/gladys-integration-unifi:1.5.2), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/guim31/gladys-integration-unifi.
UniFi Network requires Gladys >=4.62.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
UniFi Network is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by guim31, not by the Gladys core team.
- Browse all external integrations
- Discover the native integrations built into Gladys
- Build and publish your own external integration
- Source code on GitHub — source of this documentation