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.

The UniFi Network Map card in Home Assistant: an isometric map of switches, access points and clients on a dark grid, with a device selected and its detail panel open on the right. — The card in a real Home Assistant dashboard (dark theme, a NAS selected, its Actions tab open). Device names are from a home lab, not a product demo.

Latest release Latest GitHub release

GitHub →

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, using 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.