Plugin Installation Instructions

Prerequisites

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 the PLUGINS list.
- Add 'ipfabric_netbox' to the PLUGINS list as shown below:
```
PLUGINS = ['ipfabric_netbox']
```
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.

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