NetBox Attachments Plugin

NetBox plugin for attaching files to any model.

Features

This plugin provides the following model:

NetBoxAttachment: A model for attaching files to any NetBox object.

Compatibility

The following table shows the compatibility between different NetBox versions and plugin versions:

NetBox Version	Plugin Version
>= 3.3.4	0.0.0 - 0.0.5
>= 3.4.0	0.0.6 - 1.0.6
>= 3.4.3	1.0.7 - 1.1.x
>= 3.5.0	2.0.0
>= 3.6.0	3.0.0
>= 3.7.0	4.0.0
>= 4.0.0	5.x.x
>= 4.1.0	6.x.x

Installation

The plugin is available as a Python package on PyPI and can be installed with pip:

pip install netbox-attachments

To enable the plugin, add it to the PLUGINS list in your configuration.py:

PLUGINS = ['netbox_attachments']

Next, create a directory for storing attachments and set the appropriate permissions:

mkdir -p /opt/netbox/netbox/media/netbox-attachments
chown netbox /opt/netbox/netbox/media/netbox-attachments

Run the database migrations for the plugin:

python3 manage.py migrate netbox_attachments

Restart NetBox and ensure that netbox-attachments is included in your local_requirements.txt.

For more details, see the NetBox Documentation.

Configuration

Plugin Options

The plugin can be customized using the following configuration options:

apps:
- Type: List
- Default: ['dcim', 'ipam', 'circuits', 'tenancy', 'virtualization', 'wireless']
- Description: Specify the app labels where the Attachments feature should be enabled. Attachments are displayed on the right_page of the detail view of the models.
display_default:
- Type: String
- Default: "additional_tab"
- Options: "left_page", "right_page", "full_width_page", "additional_tab"
- Description: Sets the default location where attachments should be displayed in the models.
display_setting:
- Type: Dictionary
- Default: {}
- Format: {<app_label.model>: <preferred_display>}
- Example: {'dcim.devicerole': 'full_width_page', 'dcim.device': 'left_page', 'ipam.vlan': 'additional_tab'}
- Description: Override the display settings for specific models.
- Tip: Use the correct app_label and model names, which can be found in the API at <your_netbox_url>/api/extras/content-types/.

Warning: The additional_tab option does not work for plugin models.

Configuration Example

Here is an example of how to configure the plugin in configuration.py:

PLUGINS_CONFIG = {
    'netbox_attachments': {
        'apps': ['dcim', 'ipam', 'circuits', 'tenancy', 'virtualization', 'wireless', 'inventory_monitor'],
        'display_default': "right_page",
        'display_setting': {
            'ipam.vlan': "left_page",
            'dcim.device': "full_width_page",
            'dcim.devicerole': "full_width_page",
            'inventory_monitor.probe': "additional_tab"
        }
    }
}

Enabling Attachments for Custom Plugins (Models)

To enable attachments for custom plugin models:

Append your plugin to the apps configuration list:
```
apps: ['<plugin_name>']
```

Extend the detail templates of your plugin models:

{% load plugins %}  # At the top of the template

{% plugin_right_page object %}  # Under the comments section

# Add left_page and full_width for future extensions

Example (Device Model)

Screenshots

Model View:
List View:
Detail View:

Kani999 / netbox-attachments

readme