--- title: "UniFi Insights" description: "UniFi Insights is a Marketplace integration for Home Assistant. It has 413 installs sharing analytics, works locally and was last updated October 27, 2026." canonical: "https://vulpo.app/integrations/marketplace/tinkerologie-ha-unifi-insights" url: "https://vulpo.app/integrations/marketplace/tinkerologie-ha-unifi-insights.md" last-updated: "2026-10-26" version: "1.4" --- # UniFi Insights > UniFi Insights is a Marketplace integration for Home Assistant. It has 413 installs sharing analytics, works locally and was last updated October 27, 2026. UniFi Insights connects Home Assistant to UniFi Network, Protect, Access and related Ubiquiti products through an API key. It works with a console on the local network or with any console on a UniFi account through UniFi Cloud, and it is set up in the UI. It adds sensors, binary sensors, switches, buttons, cameras, locks, lights, events, device trackers and firmware updates, grouped under their UniFi devices. Actions cover tasks such as restarting devices, power cycling PoE ports, reconnecting wireless clients and exporting network rules as a document. Options let it track WiFi and wired clients, limit polling to chosen sites, and receive Access door events. Six dashboard cards are installed with it, and diagnostics redact API keys, addresses and client names. Automatic summary of the README and code of tinkerologie/ha-unifi-insights. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=tinkerologie&repository=ha-unifi-insights&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=tinkerologie&repository=ha-unifi-insights&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Connection Type - **Connection Type**: Local: Connect directly to your UniFi device on your network. Remote: Connect via UniFi Cloud using your cloud API key. ### Local Connection - **Host URL**: The URL of your UniFi device (e.g., https://192.168.1.1) - **API Key**: API key from your UniFi Controller (Settings → Control Plane → API Keys) - **Verify SSL Certificate**: Disable for self-signed certificates (common for local devices) - **UniFi Access API token (optional)**: Create this in Access \> Settings \> General \> Advanced. It is separate from the UniFi API key and enables Access doors, emergency controls and events. Leave empty to skip Access. - **UniFi Access developer API port**: Port of the UniFi Access developer API on the console. The official default is 12445. ### Remote Connection (UniFi Cloud) - **API Key**: Cloud API key from your UniFi account. After validation, you will choose one of the consoles that this API key can access. ### Select remote console - **Console**: These consoles were discovered with your API key. ### UniFi Carrier Fabric - **API Key**: An API key with Carrier Fabric ISP permissions (type ISP). Also asked when signing in again. ### Reauthenticate - **API Key**: A new API key from your UniFi Controller (Settings → Control Plane → API Keys) ### Reconfigure - **Host URL**: The URL of your UniFi device (e.g., https://192.168.1.1) - **API Key**: API key from your UniFi Controller (Settings → Control Plane → API Keys) - **Verify SSL Certificate**: Disable for self-signed certificates (common for local devices) - **Console ID**: The UniFi cloud console ID this entry connects to - **UniFi Access API token (optional)**: Enter a new token to replace the stored one. Leave empty to keep the current token. - **UniFi Access developer API port**: Port of the UniFi Access developer API on the console. - **Remove the Access token**: Turn on to remove the Access token and its access-result webhook. Ignored when a new token is entered. ### After setup - **Track WiFi Clients**: Create device tracker entities for connected WiFi clients. This may create many entities. - **Track Wired Clients**: Create device tracker entities for connected wired (LAN) clients. This may create many entities. - **Enable Client Control**: Create allow/block switch and reconnect button entities for connected clients, and Wake-on-LAN buttons (disabled by default) for wired clients. Turning this off removes client buttons. - **Sites**: Only poll these sites. Leave empty to include every site on the console. Unselected sites are not queried, which reduces API traffic on multi-site consoles. - **Track individual subscribers as devices**: Create device entries for each subscriber in your Carrier Fabric organisation. - **Enable service actions (suspend and resume subscribers)**: Allow suspending and resuming subscriber services from Home Assistant. - **Receive Access door events (granted and denied)**: Home Assistant must be reachable from the console for these events. Turn off to remove the Access webhook. Texts from the code of [tinkerologie/ha-unifi-insights](https://github.com/tinkerologie/ha-unifi-insights). ## Entities - **Alarms**: Alarm - **Binary sensors**: Status, Connection, Site-to-Site VPN, Storage Nearly Full, Motion Detection, Person Detection, Vehicle Detection, Animal Detection, Package Detection, and 11 more - **Buttons**: Device restart, PoE Power Cycle, Generate guest voucher, Unlock, Reconnect, Play, Start PTZ patrol, Stop PTZ patrol - **Covers**: Gate - **Presence**: Location - **Events**: Doorbell, Smart Detection, Door/Window, Network rule changes, Access result - **Images**: Floor plan, Latest voucher QR code, WiFi QR code - **Locks**: Lock - **Media**: Speaker - **Numbers**: Microphone Volume, Brightness Level, Chime Volume, Repeat Times, Voucher duration, Voucher guest limit, Voucher download limit, Voucher upload limit, Voucher data limit - **Selects**: HDR Mode, Video Mode, Ringtone, PTZ Preset, Liveview - **Sensors**: CPU Usage, Memory Usage, Uptime, Uplink Transmit Rate, Uplink Receive Rate, Temperature, Humidity, Battery, and 72 more - **Switches**: Status Light, High FPS Mode, Allow, Power Cycle, VPN Client, Lockdown, Evacuation - **Updates**: Firmware ## Actions - **Refresh Data**: Force an immediate refresh of UniFi Insights data. Fields: Site ID - **Restart Device**: Restart a UniFi device. Fields: Site ID, Device ID, Entity - **Set Chime Paired Doorbells**: Choose which doorbells ring a UniFi Protect chime. The selection replaces the chime's current pairing. Leave Doorbells empty to unpair every doorbell. Fields: Chime ID, Doorbells, Entity, Device - **Suspend Subscriber**: Stop a subscriber's internet service. Requires the "Enable service actions" option to be enabled on the Carrier Fabric integration entry, and an ISP API key with the suspend:service scope. Fields: Reason, Entity, Device - **Resume Subscriber**: Restore a subscriber's internet service. Requires the "Enable service actions" option to be enabled on the Carrier Fabric integration entry, and an ISP API key with the resume:service scope. Fields: Entity, Device - **Power Cycle PoE Port**: Power-cycle a PoE-enabled port on a UniFi network device. Fields: Site ID, Device ID, Port Index, Entity - **Reconnect Client**: Reconnect a connected wireless client to Wi-Fi. Accepts only clients that are currently connected and wireless. Fields: Site ID, Client ID, Entity, Device - **Remove Clients**: Remove short-lived, unnamed historical clients from the UniFi Network. Forgets clients that have no name, hostname, or fixed IP and that were seen for 15 minutes or less. If a timestamp is missing, the client is not excluded by the age check. Processes the sites selected in the integration's settings, on consoles that have Network available. Clients with a timestamp that isn't a number are kept. Requires an admin user. Does not remove Home Assistant devices or entities. - **Play Chime Ringtone**: This action always raises a not supported error because the official Protect API has no chime playback route. Fields: Chime ID, Ringtone ID, Entity, Device - **Export network rules**: Return a snapshot of the firewall policies, policy-based routes, port forwards, traffic rules, NAT rules and static routes of one console as a versioned document, for comparison, versioning and manual recovery. It is not a complete console backup: the networks, zones, traffic matching lists, groups and VPN definitions that rules refer to are not included, and there is no import. The rules are read from the console when you run the action. Only a rule type with status ok is complete. Failed means the answer could not be read, was not JSON, was incomplete or held a record that could not be parsed. Unsupported means the console refused the request, or the site has no classic name for the five rule types other than firewall policies. Requires an admin user. The action only returns data; it does not write a file. Fields: Site ID, Console, Rule types, Redact sensitive values - **Set Access user PIN**: Assign a PIN to a UniFi Access user. The PIN must be digits only; the console checks its length and returns a rejection if it does not accept the value. Requires an admin user. Fields: User ID, PIN, Console - **Remove Access user PIN**: Remove the PIN assigned to a UniFi Access user. Requires an admin user. Fields: User ID, Console - **Set Access user status**: Set a UniFi Access user account to ACTIVE or DEACTIVATED. This controls the whole account, so a deactivated user loses access through every credential. Requires an admin user. Fields: User ID, Status, Console ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## From the README > Monitor and control your UniFi system from Home Assistant: UniFi Network, UniFi Protect, UniFi Access, UniFi InnerSpace, UniFi Mobility, UniFi Site Manager and UniFi Carrier Fabric, in one integration. From the README of [tinkerologie/ha-unifi-insights](https://github.com/tinkerologie/ha-unifi-insights#readme), [Apache License 2.0](https://spdx.org/licenses/Apache-2.0.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Computers and network](https://vulpo.app/integrations/category/computers-and-network.md), Routers and network - Brand: [Ubiquiti](https://vulpo.app/integrations/ubiquiti.md) - Number: 413 installs sharing analytics; 47 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v2026.10.4, last updated October 27, 2026 - Domain: `unifi_insights` - Source: - Issues: In Vulpo: Light card, Quick Toggle card, Cover card, Lock card, Apple Watch, Control Center ## Other ways in for Ubiquiti | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [UniFi Network](https://vulpo.app/integrations/core/unifi.md) | Built-in integration | 42.8k installs sharing analytics | Works locally | Part of Home Assistant | | [UniFi Protect](https://vulpo.app/integrations/core/unifiprotect.md) | Built-in integration | 25.6k installs sharing analytics | Works locally | Part of Home Assistant | | [UniFi Access](https://vulpo.app/integrations/core/unifi-access.md) | Built-in integration | 1.6k installs sharing analytics | Works locally | Part of Home Assistant | | [Unifi Access](https://vulpo.app/integrations/marketplace/imhotep-hass-unifi-access.md) | Marketplace integration | 693 installs sharing analytics | Works locally | Updated in the last 6 months | | [UniFi Network Map](https://vulpo.app/integrations/marketplace/merlijntishauser-unifi-network-maps-ha.md) | Marketplace integration | 503 installs sharing analytics | Works locally | Updated in the last 6 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-26. Source: https://vulpo.app/integrations/marketplace/tinkerologie-ha-unifi-insights --- - HTML version of this page: https://vulpo.app/integrations/marketplace/tinkerologie-ha-unifi-insights - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml