← Back

UniFi Network Map for Home Assistant

This is my custom Home Assistant integration that turns UniFi topology data into a living, interactive map. It surfaces the network where I already manage automations, so I can see what is connected without leaving Home Assistant.

Latest release Latest GitHub release

Why I built it

The UniFi dashboard is great for day-to-day administration, but I wanted the topology view embedded in Home Assistant for quick context while working on automations and device health. The goal was a clear, at-a-glance map that feels at home in HA.

What it does

Interactive topology

Renders a live SVG network map with gateway, switches, access points, and client devices. You can pan and zoom, and the map updates without page refreshes.

Real-time updates

The integration keeps the view fresh with WebSocket-driven updates, so link changes appear as they happen.

Smart navigation

Every node can link to its Home Assistant entity, leveraging the official UniFi integration for deeper context and controls.

Built for daily use

It includes multiple visual themes, a mobile-friendly layout, and device filters to focus on specific parts of the network.

Setup highlights

The integration talks directly to the UniFi Network Application API, which means a local controller and a local user account are required. It targets Home Assistant 2024.12 or newer.