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.
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
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.
Product access
Product screenshots
