Skip to content

Plugin Installation Instructions

Prerequisites

  • Ensure you have NetBox version 3.5.0 or higher installed.

Installation Steps

  1. Install the Plugin:

    The plugin is available as a Python package on PyPI, and you can install it using pip:

    pip install ipfabric_netbox
    
  2. Ensure Automatic Reinstallation:

    To make sure the plugin is automatically reinstalled during future upgrades, follow these steps:

  3. Enable the Plugin:

    After installing the plugin, you need to enable it in the NetBox configuration file (configuration.py).

    • Open configuration.py and locate the PLUGINS list.
    • Add 'ipfabric_netbox' to the PLUGINS list as shown below:

      PLUGINS = ['ipfabric_netbox']
      
  4. Run the Upgrade Script:

    To apply the changes, run the NetBox upgrade script. You can use the following command:

    sudo /opt/netbox/upgrade.sh
    
  5. Restart Services (if necessary):

    After running the upgrade script, you may need to restart services. Refer to the documentation for more details on restarting services:

    sudo systemctl restart netbox netbox-rq
    

These steps will ensure the successful installation and activation of the plugin within your NetBox environment.

Transform Map Installation

If you would like to install our default transform maps see the following documentation.