NetBox circuit map

A simple circuit map plugin with filtering criteria for NetBox

Installation

Requirements

The plugin has been tested and confirmed works on NetBox versions from 3.5.7 and Python version 3.10.

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-circuit-map package:

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

echo netbox-plugin-circuit-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-circuit-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_circuit_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, install custom map tiles. Update PLUGINS_CONFIG parameter in the configuration.py like this:

PLUGINS_CONFIG = {
    'netbox_circuit_map': {
        '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

Setting	Default value	Description
geomap_settings	…	Geographical map settings

Geographical map settings

Setting	Default value	Description
attribution	Data by &copy; <a href="https://openstreetmap.org">OpenStreetMap</a>	Attribution text in the lower right corner of the map
crs	EPSG3857	Coordinate reference system
tiles	…	Tiles layer settings

Custom tiles layer settings:

Setting	Example value	Description
url_template	https://{s}.somedomain.com/blabla/{z}/{x}/{y}{r}.png	{s} means one of the available subdomains (used sequentially to help with browser parallel requests per domain limitation; subdomain values are specified in options; a, b or c by default, can be omitted), {z} — zoom level, {x} and {y} — tile coordinates. {r} can be used to add "@2x" to the URL to load retina tiles.
options	{'subdomains' : ['a', 'b', 'c'], 'minZoom': 0, 'maxZoom': 18}	Leaflet TileLayer options

Acknowledgements

• netbox-plugin-device-map by Victor Golovanenko, which this plugin's code is based on
• Leaflet

Leaflet plugins

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