Browser Extension
A companion extension that brings Insights Plus data directly into your UniFi Network Controller.
Breaking Change
Extension version 1.0.0 is not compatible with app version 3.3.0. If your server has authentication enabled, extension 1.1.0 or later is required and must be configured with an API token. Create one in Settings → API with client type Extension, then paste it into the extension (v1.1.0) popup.
What It Does
- Threat Badges in Flow View - Every flow in your UniFi controller gets an inline threat score badge. See at a glance which connections involve known malicious IPs, port scanners, or brute-force sources.
- Side Panel Enrichment - Click any flow row and the detail panel shows AbuseIPDB threat score, rDNS hostname, ASN/ISP name, abuse categories, and blacklist status.
- Embedded Dashboard Tab - An “Insights Plus” tab appears in your UniFi controller's navigation, embedding your full dashboard without leaving the controller.
- Click-to-Investigate - Click “View Traffic” on any enriched IP to jump directly to filtered log results in your Insights Plus instance.
- Dark/Light Mode- Automatically matches your UniFi controller's theme.
Setup
- Install and run the Insights Plus Docker container on your network
- Install the extension from the Chrome Web Store or Firefox Add-ons
- Click the extension icon and enter your Insights Plus server address
- If authentication is enabled, create an API token in Settings → API with client type Extension, then paste it into the extension popup
- Enter your UniFi controller address and grant access when prompted
- Navigate to your UniFi controller - enrichment appears automatically
Manual Install (Sideloading)
The extension is available on the Chrome Web Store and Firefox Add-ons. You can also install it manually by downloading the pre-built package from the latest GitHub release.
Chrome / Edge
- Download chrome.zip
- Unzip to a folder on your computer
- Go to
chrome://extensions(oredge://extensions) - Enable Developer mode (toggle in the top-right)
- Click Load unpacked and select the unzipped folder
Firefox
- Download unifi_log_insight-1.1.2.xpi
- Unzip to a folder on your computer
- Go to
about:debugging#/runtime/this-firefox - Click Load Temporary Add-on and select any file inside the unzipped folder
Note: Temporary add-ons in Firefox are removed when the browser restarts. For a persistent install, use the Firefox Add-ons listing.
Requirements
The extension requires a running Insights Plus server on your network. All communication stays between your browser, your UniFi controller, and your self-hosted server. No analytics, no telemetry, no third-party services.
Permissions
| Permission | Why |
|---|---|
| storage | Persist settings (server URL, controller URL, API token, toggles) |
| scripting | Inject content scripts into UniFi Controller pages for badges, panels, and the embedded tab |
| optional host access | Requested at runtime only for your specific controller URL. Never granted automatically - you see a standard permission prompt. |
Supported Browsers
- Chrome (Manifest V3)
- Firefox (Manifest V3, min version 140)
- Edge (uses Chrome package)