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…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
40/100 Fair
- Maintained
- 68last commit 118 days ago
- Popular
- 61 GitHub stars
- Easy to install
- 201 install platform, Docker image
- Light to run
- 502 GB minimum RAM
Availability: platform listings confirmed today, links checked 17 days ago
- GitHub stars
- 1
- Open issues
- 0
- Last commit
- 2026-07-25
- License
- MIT
- Activity
- stale
Checked 5 days ago - source: GitHub (FugginOld/topographer)
Resources & Compatibility
Minimum requirements: 2 GB RAM.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Point agents to the server Set TOPO_SERVER on each reporting agent, for example TOPO_SERVER=http://<Unraid-IP>:8770, using your Unraid server's IP address and the default port 8770. source
- Network interface Use the default host networking mode: the ping, arp and nmap collectors must see the real LAN, and it keeps agent pushes labelled with their true source IP. Bridge mode renders the dashboard but makes discovery blind. source
Fetched today - each note links to its source
Variants
Alternatives
No alternatives collected yet.
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.
Answers sourced from github.com
Community
- Any advise for self hosting map, thanks : r/selfhosted - Reddit (reddit)
- Open source tool for basic topo map? : r/cartography - Reddit (reddit)
- Network and App Diagrams : r/selfhosted - Reddit (reddit)
Collected 49 days ago - public community threads