I built a topology map for UniFi network, with lovelace custom card

The native UniFi integration does a lot of things well: presence detection, device control, PoE switches. But it never shows you what your network actually looks like. Which client is on which AP. Which switch connects where. That always bugged me, so I built this.

UniFi Network Map is a custom integration that adds an interactive topology map directly to your dashboard. Pan, zoom, tap a device to see its IP/MAC/firmware, and if you have the official UniFi integration installed it’ll link straight through to the HA entity.

It updates in real-time via WebSocket, so when a client connects or drops off, the map updates automatically.

Get it via HACS. Search for UniFi Network Map, or grab it at:
GitHub - merlijntishauser/unifi-network-maps-ha: Interactive UniFi network topology map for Home Assistant. Visualize device connections, monitor client presence, and display your network structure in a live Lovelace card. · GitHub

What you need:

  • HA 2024.12+
  • UniFi Network controller (Supported device or self-hosted)
  • A local UniFi account (not your cloud account)
  • LLDP enabled on your devices

If your map comes up empty, LLDP is almost always the reason — happy to help you sort it out in the comments.

Would love to hear how it looks on your setup!

1 Like