IPv4 / MAC lookup
The documented 1.0.2 release supports endpoint lookup by IPv4 or MAC.
Open-source / Installable
NetBox Endpoint Locator
NetBox Endpoint Locator links NetBox with LibreNMS to locate endpoints by IP / MAC / VLAN / port evidence, reducing manual table lookup across systems.
What is NetBox Endpoint Locator
NetBox Endpoint Locator is a NetBox plugin that correlates LibreNMS IP, MAC, VLAN, and port evidence to locate endpoint access paths directly from the NetBox interface.
Who it is for
- NetBox users locating an endpoint switch port from an IP or MAC
- Network teams reusing LibreNMS evidence to reduce manual cross-system queries
What problem it solves
Endpoint access locations often require manual correlation across NetBox, LibreNMS, ARP, MAC tables, and interface data.
Core capabilities
LibreNMS evidence correlation
LibreNMS evidence covers IP, MAC, VLAN, port, and device data while filtering aggregation, routed, and trunk-like ports.
NetBox device mapping
LibreNMS device and interface evidence is mapped back to NetBox device records to reduce manual cross-system lookup.
Access-port filtering
Candidate ports exclude aggregation, routed, and trunk-like interfaces so likely endpoint access ports remain.
Typical workflows
- Enter an IPv4 or MAC in NetBox
- Query LibreNMS for IP, MAC, VLAN, port, and device evidence
- Filter aggregation, routed, and trunk-like ports
- Map the final device back to NetBox and display the result
Use cases
- Endpoint location
- Access-path tracing
- Network asset verification
Inputs
- IPv4 or MAC address
- LibreNMS API data
- NetBox device inventory
Outputs
- Candidate and final access device
- Switch interface and VLAN evidence
- Mapped NetBox device link
Deployment and data boundary
- The plugin runs in the user's own NetBox environment
- Queries use the configured LibreNMS URL and token
- It does not replace NetBox inventory or LibreNMS monitoring
Clone repository
git clone https://github.com/Jaycelu/netbox_-endpoint_locator.git
cd netbox_-endpoint_locatorInstall the plugin
pip install -e .Enable in NetBox
PLUGINS = ["netbox_endpoint_locator"]
PLUGINS_CONFIG = {
"netbox_endpoint_locator": {
"librenms_url": "http://127.0.0.1:8000",
"librenms_token": "YOUR_TOKEN"
}
}Restart NetBox
sudo systemctl restart netbox netbox-rqSystem requirements
- NetBox 4.4.x
- Python 3.10 or later
- Reachable LibreNMS API and access token
Current version and update
1.0.2
Published：2026-03-23
Content updated：2026-07-14
Known limitations
- The target environment is NetBox 4.4.x
- Results depend on the completeness of ARP, FDB, VLAN, and interface data in LibreNMS
How it compares
Manual ARP/MAC table lookups
Manual lookups span NetBox, LibreNMS, and switch CLI. Endpoint Locator correlates evidence in one step and maps it back to NetBox device records.
LibreNMS native endpoint queries
LibreNMS provides device-level data but does not link results to NetBox inventory. Endpoint Locator maps LibreNMS findings to NetBox device records.
Commercial endpoint tracing solutions
Commercial solutions require separate licensing and deployment. Endpoint Locator is a free open-source NetBox plugin leveraging existing infrastructure.
Frequently asked questions
Which identifiers can be queried?
The current plugin supports IPv4 and MAC address lookups.
Why are both NetBox and LibreNMS needed?
LibreNMS supplies dynamic IP, MAC, VLAN, and port evidence while NetBox provides normalized device inventory and links.
Does the plugin change device configurations?
No. It reads LibreNMS and NetBox data for location and does not push configuration changes.
Is LibreNMS required?
Yes. The plugin uses LibreNMS API data as its evidence source and does not replace LibreNMS monitoring.
How accurate are the results?
Accuracy depends on the completeness of ARP, FDB, VLAN, and interface data in LibreNMS. The plugin filters aggregation, routed, and trunk-like ports to narrow results.
Related technical guides
No complete English guide is published for this product yet.
Product access
Product screenshots
