NetBox Map

A NetBox plugin for interactive floor plan visualization, site maps, rack utilization, and cable tracing.

Links: Documentation | NetBox Ping | Website | Demo

Features

Floor Plans

• Canvas-based editor with drag-and-drop tile placement, pan/zoom, and configurable grids
• 12 tile types -- rack, aisle, wall, column, door, cooling, power, empty, reserved, access point, camera, printer
• Tile orientation (0/90/180/270°) -- text rotates to match, so narrow vertical tiles stay readable
• Link tiles to NetBox objects (racks, devices, power panels, power feeds, ports)
• Background image upload for blueprints or photos
• PDF export with all visible tiles, labels, and FOV cones

Rack Visualization

• Utilization heatmap -- color gradient from green (0%) to red (90%+) directly on tiles
• Expand racks in the sidebar to see all devices sorted by U-position
• Full rack elevation SVG (front/rear) in the detail panel
• Search across device names and IPs inside racks

Cable Tracing

• Full cable trace for devices, rear ports, and front ports
• Unified traces through patch panels (Server:eth0 → Cable → FrontPort → RearPort → Cable → Switch:Gig1/0/3)
• "Show on map" buttons to zoom to devices that exist on the floor plan
• Rack device traces -- expand a rack, click the cable icon on any device

Camera FOV

• Configurable direction (0-360°), angle (10-360°), and distance (1-50 cells)
• Live preview of semi-transparent FOV cones on the canvas
• Toggle all FOV cones on/off

Global Site Map

• Leaflet.js geographic map with OpenStreetMap tiles
• Sites, locations, floor plan tiles, and standalone markers on one map
• Edit mode -- place sites, locations, and markers by clicking the map
• Drag to reposition, auto-saves coordinates
• GPS sync -- automatically writes lat/lng to device records when placed on the map
• Early fiber/cable path support (experimental -- expect breaking changes in future releases)

Settings (Web UI)

• Configure detail panel fields per object type from the browser
• Toggle MAC address display, custom fields, GPS sync
• No file editing or restarts needed

Network Topology

• Interactive topology view with stencil device cards and interface ports
• Hierarchical layout, orthogonal cable routing with obstacle avoidance
• Saved views with position persistence and filters
• PDF export, cable coloring by type or speed, pass-through collapse

Application Mapping

• Model applications, deployments to devices/VMs, and inter-app dependencies
• Application topology view with dependency edges and failure simulation
• Mixed mode: devices + apps + deployed-on connections on one canvas
• Templates for bulk application deployment
• Device/VM detail page integration (Applications tab + panel)

Integration

• Site detail page panel with floor plan links
• Device detail page "Map Locations" tab
• Global search indexing for floor plans, tiles, and markers
• Change logging on all models
• REST API with full CRUD, filtering, and search
• Dark mode support

Screenshots

Installation

source /opt/netbox/venv/bin/activate
pip install netbox-map

Or from source:

source /opt/netbox/venv/bin/activate
pip install git+https://github.com/DenDanskeMine/netbox-map.git

Add to configuration.py:

PLUGINS = [
    'netbox_map',
]

Apply migrations and restart:

cd /opt/netbox/netbox
python3 manage.py migrate
python3 manage.py collectstatic --no-input
sudo systemctl restart netbox

GPS Sync

When enabled, placing a device on a map automatically writes lat/lng to the device record. Clearing the tile/marker clears the GPS if no other map references remain.

Maps URL Deep-Linking

Point NetBox's built-in Map button to this plugin instead of Google Maps:

1. Go to Admin > Configuration > Miscellaneous
2. Set Maps URL to: https://your-netbox-url/plugins/map/sitemap/?q=
3. Save

Now clicking the Map button on any Site or Device opens the plugin's site map centered on that location.

REST API

All endpoints support filtering, pagination, and brief mode.

Compatibility

Dependencies

• No additional Python packages required (only NetBox itself)

Development

git clone https://github.com/DenDanskeMine/netbox-map.git
cd netbox-map
pip install -e .

License

Apache License 2.0 -- see LICENSE.

Support

Open an issue on GitHub.