Skip to content

Feature Overview

Device Import

  • Search and discover devices from LibreNMS using flexible filters
  • Validate device prerequisites before import (Site, Device Type, Device Role)
  • Import devices as physical Devices or Virtual Machines
  • Smart matching for Sites, Device Types, and Platforms (via mapping rules)
  • Unified Platform creation modal — same experience on import page and device sync page
  • Bulk import support
  • Automatic Virtual Chassis creation for stackable devices
  • Background job processing for large device sets
  • Duplicate detection to prevent re-importing existing devices

Module / Inventory Sync

  • Compare LibreNMS ENTITY-MIB inventory to NetBox module bays and installed modules
  • Install, update, or skip modules directly from the sync table
  • Match statuses: Matched, No Bay, No Type, Name Conflict, Not Installed
  • Inline modal to create missing ModuleBayTemplate, ModuleTypeMapping, or ModuleBayMapping without leaving the page
  • Carrier Auto-Install suggestion for chassis that omit holder modules from SNMP

Mapping Rules

  • Platform Mappings — LibreNMS OS string to NetBox Platform
  • Device Type Mappings — LibreNMS hardware string to NetBox DeviceType
  • Module Type Mappings — LibreNMS entPhysicalModelName to NetBox ModuleType (with manufacturer scoping)
  • Module Bay Mappings — LibreNMS entPhysicalName to NetBox bay name (exact or regex, manufacturer scoping)
  • Normalization Rules — regex-based string transformation before matching (strips vendor suffixes etc.)
  • Inventory Ignore Rules — skip or make-transparent phantom EEPROM/IDPROM entities
  • Carrier Auto-Install Rules — suggest carrier module installation for vendors that omit them from SNMP
  • Bulk YAML import/export for all mapping types
  • Vendor-contributed example rules in contrib/

Plugin Settings

  • Multi-server LibreNMS configuration support
  • Configurable device naming defaults (sysName vs hostname)
  • Domain stripping options during import for cleaner device names
  • Virtual Chassis member naming pattern customization during import

Device

  • LibreNMS device identification via:
  • Custom field librenms_id (recommended)
  • Primary IP address
  • Primary IP DNS name
  • Hostname
  • Add device to LibreNMS from netbox via SNMP v2c or v3

Virtual Chassis Support

  • Automatic VC member selection for each interface
  • Member-specific interface synchronization
  • Bulk member editing capabilities

Interface Sync

  • Create or Update interface in NetBox from LibreNMS interface data
  • Name
  • Description
  • Status (Enabled/Disabled)
  • Type (with custom mapping support)
  • Speed
  • MAC Address
  • MTU
  • VLAN assignments
  • Sync all or specific fields

Cable Sync

  • Create Cable connection in NetBox from LibreNMS links data
  • Best results when the custom field librenms_id is populated on interfaces

IP Address Sync

  • Create IP address objects in Netbox from LibreNMS device IP data
  • Optionally set the device or VM Primary IP from the LibreNMS management IP (opt-in Set Primary IP toggle on the IP Address Sync tab)
  • Best results when the custom field librenms_id is populated on interfaces

VLAN Sync

  • Create VLAN objects in NetBox from LibreNMS device VLAN data
  • Per-VLAN group assignment with scope-aware auto-selection

Location

  • NetBox Site to LibreNMS location synchronization
  • Sync location latitude and longitude values from NetBox to LibreNMS

Interface Mapping

  • Customizable LibreNMS to NetBox interface type mappings
  • Interface Speed-based mapping rules
  • Bulk import support