# Topographer

Topographer is a self-hosted dashboard that auto-discovers the machines and services on your homelab local area network and renders them as a live network and hardware topology map. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3400/topographer

## Description

Topographer is a self-hosted dashboard that auto-discovers the machines and services on your homelab local area network and renders them as a live network and hardware topology map. Scanners and collectors gather the data, a pipeline normalizes and enriches it (vendor lookup, VLAN by subnet, device kind), and reporting agents on other hosts push their own map plus telemetry to this server. It also serves per-host service widgets and live Glances metrics, giving you a running overview of every connected device without manually running discovery commands.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

40/100 (Fair), based on 4 of 4 factors.
- Maintained: 68 (last commit 118 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)
- Light to run: 50 (2 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/topographer-0vd59hx0evy0x5?q=topographer
- GitHub: https://github.com/FugginOld/topographer

## Common questions

### What port does the Topographer web dashboard use?

The dashboard is served on port 8770. You start topo_server.py and then open the server's address on that port.

### How do I run Topographer as a service on Linux?

Use install.sh to set the dashboard up as a systemd service that starts on boot and prints its URL. Uninstall.sh removes the service.

### How do I connect additional machines to the fleet dashboard?

Run the agent script on each machine: report.sh for Linux, report.ps1 for Windows, or bootstrap.sh for a fresh Debian box. The agent pushes that host's hardware topology and live telemetry to the server.

### Can I start the network scan without creating a config file?

Yes. You can open the dashboard and click SCAN NETWORK with no config at all.

### Are the discovered IPs, MACs, and hostnames committed to the repository?

No. The actual topology, including IPs, MACs, hostnames, and VLAN policy, is a build artifact and is gitignored.

### How does Topographer merge duplicate entries from multiple collectors?

It merges collectors into one topology, dedupes by MAC address, then reconciles entries by IP address and hostname.

---
Source: Our Local Host (https://ourlocalhost.com/app/3400/topographer), the self-hosted and open-source app directory.
