Diode NetBox Plugin

The Diode NetBox plugin is a NetBox plugin. It is a required component of the Diode ingestion service.

Diode is a NetBox ingestion service that greatly simplifies and enhances the process to add and update network data in NetBox, ensuring your network source of truth is always accurate and can be trusted to power your network automation pipelines.

More information about Diode can be found at https://netboxlabs.com/blog/introducing-diode-streamlining-data-ingestion-in-netbox/.

Compatibility

NetBox Version	Plugin Version
>= 3.7.2	0.1.0
>= 4.1.0	0.4.0
>= 4.2.3	1.0.0
>= 4.2.3	1.1.0
>= 4.2.3	1.2.0
>= 4.4.0	1.4.0
>= 4.4.0	1.4.1
>= 4.4.10	1.7.0
>= 4.5.0	1.7.0
>= 4.6.0	1.12.0
>= 4.7.0	1.17.0

Installation

Source the NetBox Python virtual environment:

cd /opt/netbox
source venv/bin/activate

Install the plugin:

pip install netboxlabs-diode-netbox-plugin

In your NetBox configuration.py file, add netbox_diode_plugin to the PLUGINS list.

PLUGINS = [
    "netbox_diode_plugin",
]

Also in your configuration.py file, in order to customise the plugin settings, add netbox_diode_pluginto the PLUGINS_CONFIG dictionary, e.g.:

PLUGINS_CONFIG = {
    "netbox_diode_plugin": {
        # Diode gRPC target for communication with Diode server
        "diode_target_override": "grpc://localhost:8080/diode",

        # Username associated with changes applied via plugin
        "diode_username": "diode",

        # netbox-to-diode client_secret created during diode bootstrap.
        "netbox_to_diode_client_secret": "..."
    },
}

If you are running diode locally via the quickstart, the netbox-to-diode client_secret may be found in /path/to/diode/oauth2/client/client-credentials.json. eg:

echo $(jq -r '.[] | select(.client_id == "netbox-to-diode") | .client_secret' /path/to/diode/oauth2/client/client-credentials.json)

Note: Once you customise usernames with PLUGINS_CONFIG during first installation, you should not change or remove them later on. Doing so will cause the plugin to stop working properly.

Restart NetBox services to load the plugin:

sudo systemctl restart netbox netbox-rq

See NetBox Documentation for details.

Configuration

Source the NetBox Python virtual environment (if not already):

cd /opt/netbox
source venv/bin/activate

Run migrations to create all necessary resources:

cd /opt/netbox/netbox
./manage.py migrate netbox_diode_plugin

Running Tests

make docker-compose-netbox-plugin-test

Generating Documentation

Generates documentation on how diode entities are matched. The generated documentation is output to here.

make docker-compose-generate-matching-docs

License

Distributed under the NetBox Limited Use License 1.0. See LICENSE.md for more information.

Required Notice

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

netboxlabs_diode_netbox_plugin-1.17.0.tar.gz (165.7 kB view details)

Uploaded Sep 3, 2026 Source

File details

Details for the file netboxlabs_diode_netbox_plugin-1.17.0.tar.gz.

File metadata

Download URL: netboxlabs_diode_netbox_plugin-1.17.0.tar.gz
Upload date: Sep 3, 2026
Size: 165.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for netboxlabs_diode_netbox_plugin-1.17.0.tar.gz
Algorithm	Hash digest
SHA256	`632e72572dfb31293d8526786aeac02ab439fdb9abd7c7d74d03313c9295f7c4`
MD5	`0bdff09911d10ef94004af2e42f4e1ac`
BLAKE2b-256	`ee0737718cd90c669c113e2dc458a41ea0d273ddaf392e819286e44d9b62608b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for netboxlabs_diode_netbox_plugin-1.17.0.tar.gz:

Publisher: release.yaml on netboxlabs/diode-netbox-plugin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: netboxlabs_diode_netbox_plugin-1.17.0.tar.gz
- Subject digest: 632e72572dfb31293d8526786aeac02ab439fdb9abd7c7d74d03313c9295f7c4
- Sigstore transparency entry: 2698924638
- Sigstore integration time: Sep 3, 2026
Source repository:
- Permalink: netboxlabs/diode-netbox-plugin@b659836502c882770cdba168f0aad4e6f6a6623b
- Branch / Tag: refs/heads/release
- Owner: https://github.com/netboxlabs
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yaml@b659836502c882770cdba168f0aad4e6f6a6623b
- Trigger Event: push