NetBox device map

A simple device map plugin with filtering criteria for NetBox

Installation

Requirements

The plugin has been tested and confirmed works on NetBox versions from 3.2 to 3.5 and Python versions from 3.10 to 3.11.

Steps

1. If your NetBox installation uses virtualenv, activate it like this:

source /opt/netbox/venv/bin/activate

2. Install the plugin.

To ensure plugin is automatically re-installed during future NetBox upgrades, create a file named local_requirements.txt (if not already existing) in the NetBox root directory and list the nextbox-plugin-device-map package:

• Option A: if you want to install it from PyPI:

echo netbox-plugin-device-map | sudo tee -a /opt/netbox/local_requirements.txt

• Option B: if you manually downloaded the plugin distribution from releases:

echo "/path/to/netbox-plugin-device-map.tar.gz" | sudo tee -a /opt/netbox/local_requirements.txt

Then run:

sudo pip install -U -r /opt/netbox/local_requirements.txt

to install the plugin.

3. Collect static files:

sudo python /opt/netbox/netbox/manage.py collectstatic

4. To enable plugin, add the plugin's name to the PLUGINS list in configuration.py (it's usually located in /opt/netbox/netbox/netbox/) like so:

PLUGINS = [
    'netbox_device_map'
]

5. Restart NetBox WSGI service to apply changes:

sudo systemctl restart netbox

Configuration

You can customize plugin behavior according to your needs. For example, change the custom field that contains device coordinates or install custom map tiles. Update PLUGINS_CONFIG parameter in the configuration.py like this:

PLUGINS_CONFIG = {
    'netbox_device_map': {
        'device_geolocation_cf': 'coordinates',
        'cpe_device_role': 'CPE',
        'geomap_settings': {
            'attribution': '<a href="https://osm.yourdomain.net">Your company</a> | © <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors',
            'tiles': {
                'url_template': 'https://osm.yourdomain.net/hot/{z}/{x}/{y}.png',
                'options': {
                    'maxZoom': 19
                }
            }
        }
    }
}

Settings

Geographical map settings

Custom tiles layer settings:

Acknowledgements

• Leaflet

Leaflet plugins

• leaflet.fullscreen
• Leaflet-SVGIcon
• leaflet-sidebar