Plugin Installation Instructions
Prerequisites
- Ensure you have NetBox version
3.5.0
or higher installed.
Installation Steps
-
Install the plugin:
The plugin is available as a Python package on PyPI, and you can install it using
pip
:pip install ipfabric_netbox
-
Ensure automatic re-installation:
To make sure the plugin is automatically reinstalled during future upgrades, follow these steps:
- Create a file named local_requirements.txt in the NetBox root directory if it doesn’t already exist.
- Inside the local_requirements.txt file, add the
ipfabric_netbox
package.
-
Enable the plugin:
After installing the plugin, you need to enable it in the NetBox configuration file (
configuration.py
).- Open
configuration.py
and locate thePLUGINS
list.
-
Add
'ipfabric_netbox'
to thePLUGINS
list as shown below:PLUGINS = ['ipfabric_netbox']
- Open
-
Run the upgrade script:
To apply the changes, run the NetBox upgrade script. You can use the following command:
sudo /opt/netbox/upgrade.sh
-
Restart services (if necessary):
After running the upgrade script, you may need to restart services:
sudo systemctl restart netbox netbox-rq
For more details on restarting services, refer to the documentation.
These steps will ensure the successful installation and activation of the plugin within your NetBox environment.
Installation Steps for Netbox running in Docker
Please refer to the official documentation for latest procedure on using Plugins with Netbox Docker.
Transform Map Installation
If you would like to install our default transform maps, see the documentation.