Why Self-Host Network Discovery and Topology Mapping
If you manage more than a handful of switches, routers, or access points, you need a reliable way to know what devices are on your network, how they are connected, and which ports are active. Cloud-based network management tools require sending SNMP credentials and topology data to external servers — a security risk most organizations cannot accept.
Self-hosted network discovery tools solve this by running entirely on your infrastructure. They scan your network via SNMP, CDP/LLDP, and ARP tables to build real-time topology maps, track MAC address movements, and maintain device inventories. Whether you run a corporate LAN, a university campus network, or a homelab with dozens of devices, having a local discovery platform gives you complete visibility without exposing sensitive network data.
In this guide, we compare three of the most capable open-source network discovery and topology mapping platforms available in 2026: Netdisco, LibreNMS, and OpenNetAdmin (ONA).
Tool Overview and GitHub Statistics
| Feature | Netdisco | LibreNMS | OpenNetAdmin |
|---|---|---|---|
| GitHub Stars | 864 | 4,679 | 145 |
| Last Updated | April 2026 | April 2026 | December 2025 |
| Language | Perl | PHP | PHP |
| License | BSD-2-Clause | GPL-3.0 | MIT |
| Primary Focus | Network discovery, port tracking | Full network monitoring + discovery | IP address management, device inventory |
| Web UI | Yes | Yes (modern, responsive) | Yes (basic, functional) |
| Docker Support | Official image | Official image | Community images |
| Database | PostgreSQL | MySQL/MariaDB | MySQL/MariaDB |
| SNMP Versions | v1, v2c, v3 | v1, v2c, v3 | v1, v2c, v3 |
| Topology Maps | Yes (Graphviz-based) | Yes (network maps) | Limited (manual) |
| MAC Address Tracking | Excellent | Good | Basic |
| VLAN Discovery | Yes | Yes | Manual entry |
| CDP/LLDP Support | Yes | Yes | Limited |
| Auto-Discovery | Yes | Yes | Manual/semi-auto |
| API | REST API | REST API | REST API |
| Plugin System | Yes | Extensive | Limited |
Netdisco (netdisco/netdisco) is a purpose-built network discovery tool developed originally by the University of Washington and now maintained by a community of network administrators. It excels at SNMP-based device discovery, port-to-MAC address mapping, and VLAN tracking. Its strength is doing one thing very well: telling you exactly what is connected to every port on every switch in your network.
LibreNMS (librenms/librenms) is a full-featured network monitoring system that forked from Observium in 2013. While its primary identity is as a monitoring platform (metrics, alerting, graphs), it includes robust auto-discovery capabilities through SNMP, CDP, FDP, LLDP, OSPF, BGP, and ARP. Its network map visualization and device auto-categorization make it the most visually polished option. For a deep dive into how LibreNMS compares as a monitoring tool, see our LibreNMS vs Zabbix vs Netdata network monitoring comparison.
OpenNetAdmin (ONA) (opennetadmin/ona) is a web-based IP address and device inventory management tool. It focuses on maintaining an accurate record of your network’s IP allocations, subnet assignments, and device attributes. While its auto-discovery capabilities are more limited than Netdisco or LibreNMS, it provides excellent manual inventory management and subnet planning features.
Installation and Deployment
Netdisco Docker Deployment
Netdisco provides an official Docker image with a bundled PostgreSQL database. The recommended approach uses Docker Compose with separate services for the web interface and the polling daemon:
| |
After starting the stack with docker compose up -d, access the web interface at http://<server-ip>:5000. The default credentials are admin / admin — change these immediately.
LibreNMS Docker Deployment
LibreNMS offers an official Docker image maintained by the community. Here is a complete Docker Compose setup with all required dependencies:
| |
After deployment, complete the setup wizard at http://<server-ip>:8080/install.php. LibreNMS will guide you through database initialization and initial device discovery configuration.
OpenNetAdmin Docker Deployment
OpenNetAdmin does not have an official Docker image, but community-maintained images are available. Here is a working deployment using a community image:
| |
If a community image is unavailable, you can install ONA on any LAMP stack:
| |
SNMP Configuration for Network Discovery
All three tools rely on SNMP to discover and inventory network devices. Proper SNMP configuration on your network equipment is essential for accurate discovery.
Configuring SNMPv3 on Cisco Switches
SNMPv3 is strongly recommended over v2c because it supports authentication and encryption:
| |
Configuring SNMPv3 on Juniper Devices
| |
SNMP Credential Management in Netdisco
Once your devices are configured, add SNMP credentials to Netdisco through the admin interface or by editing the deployment.yml configuration:
| |
Netdisco will attempt each credential set in order during discovery, falling back gracefully when a device does not support a particular SNMP version.
Feature Deep Dive: Network Topology Mapping
Netdisco Topology Discovery
Netdisco builds topology maps by correlating data from multiple sources:
- LLDP (Link Layer Discovery Protocol) — directly discovers physical connections between neighboring devices
- CDP (Cisco Discovery Protocol) — Cisco-proprietary equivalent of LLDP
- FDP (Foundry Discovery Protocol) — Brocade/Foundry equivalent
- Bridge MIB (STP) data — infers connections by analyzing MAC address tables across switches
- ARP table correlation — maps IP addresses to physical ports
The resulting topology is visualized through Graphviz-generated diagrams showing device-to-device links, port-to-port connections, and VLAN membership. Netdisco’s strength is its accuracy — it does not guess connections; it derives them from actual switch forwarding tables.
LibreNMS Network Maps
LibreNMS generates network maps using the xDP (CDP/LLDP/FDP/NDP/EDP/SONMP) data collected during polling. Its map interface is interactive and visually polished:
- Auto-generated maps — created from xDP neighbor data without manual configuration
- Custom maps — manually arrange devices and draw connections for documentation purposes
- Device categorization — automatically classifies devices as routers, switches, firewalls, servers, etc.
- Geographic maps — plot devices on a world map using GPS coordinates stored in device metadata
LibreNMS also integrates with Weathermap (a plugin) to create bandwidth utilization overlays on topology diagrams, showing which links are congested at a glance.
OpenNetAdmin Inventory Management
ONA takes a different approach to network visibility. Rather than automatic topology mapping, it focuses on maintaining an accurate, manually-curated inventory:
- Subnet management — define subnets, track IP allocations, and visualize utilization
- Device records — maintain detailed hardware and software inventories
- Rack diagrams — document physical device placement in data center racks
- DHCP scope tracking — correlate DHCP-assigned addresses with static allocations
ONA’s strength is its IP address management (IPAM) capabilities. If your primary need is tracking which IP addresses are assigned to which devices across multiple subnets, ONA provides a clean, searchable database for this purpose.
Choosing the Right Tool
The decision depends on your primary use case:
Choose Netdisco if:
- Your main goal is knowing what device is connected to every switch port
- You need accurate MAC address tracking and VLAN auditing
- You manage a campus or enterprise network with hundreds of switches
- You want automated, ongoing discovery without manual inventory entry
Choose LibreNMS if:
- You need both discovery and monitoring in a single platform
- You want beautiful, interactive network topology maps
- You need alerting, graphing, and threshold monitoring alongside discovery
- You prefer a modern, responsive web interface with mobile support
Choose OpenNetAdmin if:
- Your primary need is IP address management and subnet planning
- You want a lightweight tool focused on inventory tracking
- You need to document rack layouts and physical device placement
- You have a smaller network where manual inventory entry is feasible
For teams already running LibreNMS for monitoring, adding network discovery is essentially free — just enable the auto-discovery feature and configure SNMP credentials. If you already use a dedicated monitoring platform like Zabbix or Netdata, Netdisco provides the discovery layer that monitoring tools often lack.
Scaling Considerations
| Metric | Netdisco | LibreNMS | OpenNetAdmin |
|---|---|---|---|
| Recommended Max Devices | 2,000+ | 5,000+ | 500 |
| Database Size (1,000 devices) | ~5 GB | ~10 GB | ~1 GB |
| Polling Interval | 4-8 hours | 5-15 minutes | Manual/N/A |
| Horizontal Scaling | Multiple daemons | Distributed pollers | Single instance |
| SNMP Walk Performance | Fast (optimized) | Moderate (full polling) | N/A |
Netdisco separates the web frontend from the polling daemon, allowing you to run multiple daemon instances for parallel polling. LibreNMS supports distributed pollers through its dispatcher service, making it suitable for geographically distributed networks. ONA is primarily a single-instance application and does not scale well beyond a few hundred devices.
Related Reading
For broader network infrastructure management, see our network scanning tools comparison for proactive device discovery, and our IP address management guide for subnet planning and IP tracking.
FAQ
What is the difference between network discovery and network monitoring?
Network discovery focuses on finding devices on your network, mapping how they are connected, and maintaining an inventory of hardware and configurations. Network monitoring focuses on collecting metrics (CPU, memory, bandwidth, error rates) and generating alerts when thresholds are exceeded. Tools like Netdisco excel at discovery, while LibreNMS covers both discovery and monitoring in one platform.
Do these tools support SNMPv3 encryption?
Yes, all three tools support SNMPv3 with authentication (SHA/MD5) and privacy/encryption (AES/DES). SNMPv3 is strongly recommended for production environments because SNMPv2c sends community strings in plaintext, which can be intercepted on the network.
Can I discover wireless access points and controllers?
Yes. Netdisco and LibreNMS can discover wireless controllers (Cisco WLC, Aruba, UniFi) via SNMP and map connected access points. They can also discover wireless clients by reading the controller’s client tables, giving you visibility into who is connected to which access point.
How often should I run network discovery scans?
For Netdisco, a full discovery scan every 4-8 hours is typical for stable networks. LibreNMS polls devices every 5-15 minutes for monitoring purposes, with discovery data refreshed on each poll. OpenNetAdmin requires manual updates or scripted imports, so the refresh rate depends on your processes. More frequent scans catch topology changes faster but increase network traffic and database load.
Can these tools integrate with existing monitoring systems?
Yes. LibreNMS is a monitoring system itself, so no integration is needed. Netdisco provides a REST API that can feed discovery data into external monitoring platforms. OpenNetAdmin also offers a REST API for integration with ticketing systems, configuration management databases (CMDBs), and monitoring dashboards.
Do I need root access on network devices for discovery?
No. Network discovery tools use SNMP, which is a read-only protocol. You only need to configure SNMP community strings (v2c) or SNMPv3 credentials on your devices. No SSH or root access is required for basic discovery. However, some advanced features like configuration backup may require SSH access.