Plugin installation not working

[jczmok-iag]

Diode NetBox Plugin version

1.0.0

NetBox version

NetBox Community v4.2.8 (2025-04-22)

Diode version

latest git

Diode SDK type

diode-sdk-python

Diode SDK version

v1.0.0

Steps to reproduce

1. Server installation (https://github.com/netboxlabs/diode/tree/develop/diode-server#readme)
2. Plugin install (which fails): https://github.com/netboxlabs/diode-netbox-plugin

According to docs, migrate:

(venv) root@netbox:/opt/netbox# cd /opt/netbox/netbox
./manage.py migrate netbox_diode_plugin
Operations to perform:
Apply all migrations: netbox_diode_plugin
Running migrations:
No migrations to apply.
Your models in app(s): 'netbox_diode_plugin' have changes that are not yet reflected in a migration, and so won't be applied.
Run 'manage.py makemigrations' to make new migrations, and then re-run 'manage.py migrate' to apply them.

Also makemigrations does not work
CommandError: This command is available for development purposes only. It will
NOT resolve any issues with missing or unapplied migrations. For assistance,
please post to the NetBox discussion forum on GitHub:
https://github.com/netbox-community/netbox/discussions

Then try to run the usual stuff:

python3 /opt/netbox/netbox/manage.py migrate
python3 /opt/netbox/netbox/manage.py collectstatic

venv) root@netbox:/opt/netbox/netbox# python3 /opt/netbox/netbox/manage.py migrate
Operations to perform:
Apply all migrations: account, auth, circuits, contenttypes, core, dcim, django_rq, extras, ipam, netbox_acls, netbox_bgp, netbox_config_diff, netbox_diode_plugin, netbox_floorplan, netbox_inventory, netbox_secrets, netbox_topology_views, sessions, social_django, taggit, tenancy, users, validity, virtualization, vpn, wireless
Running migrations:
No migrations to apply.
Your models in app(s): 'netbox_diode_plugin' have changes that are not yet reflected in a migration, and so won't be applied.
Run 'manage.py makemigrations' to make new migrations, and then re-run 'manage.py migrate' to apply them.
CommandError: This command is available for development purposes only. It will
NOT resolve any issues with missing or unapplied migrations. For assistance,
please post to the NetBox discussion forum on GitHub:
https://github.com/netbox-community/netbox/discussions

Please advise

Expected behavior

working :-)

Observed behavior

see above.

[sandyis]

I also cannot install the diode plugging but getting different error @mfiedorowicz , last week because 1.0.0 was not published but today looks like netbox-plugin.yaml file

• python is 3.10
• netbox 4.2.8 new clean install
• tried to install diode-netbox-plugin as per this guide
• is it possible that it is because in the netbox-plugin.yaml max version is 4.2.3 ?
• `version: 0.1
  package_name: netboxlabs-diode-netbox-plugin
  compatibility:
  • release: 1.0.0
    netbox_min: 4.2.3
    netbox_max: 4.2.3`

sudo pip install netboxlabs-diode-netbox-plugin=1.0.0 ERROR: Invalid requirement: 'netboxlabs-diode-netbox-plugin=1.0.0' Hint: = is not a valid operator. Did you mean == ? hnsi@hnsiai2:/opt/netbox$ sudo pip install netboxlabs-diode-netbox-plugin==1.0.0 Collecting netboxlabs-diode-netbox-plugin==1.0.0 Using cached netboxlabs_diode_netbox_plugin-1.0.0.tar.gz (40 kB) Installing build dependencies ... done Getting requirements to build wheel ... done Preparing metadata (pyproject.toml) ... done WARNING: Generating metadata for package netboxlabs-diode-netbox-plugin produced metadata for project name unknown. Fix your #egg=netboxlabs-diode-netbox-plugin fragments. Discarding https://files.pythonhosted.org/packages/3b/7e/070fdaeb26ae776ea36d11afc9fc050bc1b4739418e20e0cec0af1663185/netboxlabs_diode_netbox_plugin-1.0.0.tar.gz#sha256=3bd91bf3e8cd5a2696c8570f9af25d670dffebe3ae312b74ff065a17fbb20fa3 (from https://pypi.org/simple/netboxlabs-diode-netbox-plugin/) (requires-python:>=3.8): Requested unknown from https://files.pythonhosted.org/packages/3b/7e/070fdaeb26ae776ea36d11afc9fc050bc1b4739418e20e0cec0af1663185/netboxlabs_diode_netbox_plugin-1.0.0.tar.gz#sha256=3bd91bf3e8cd5a2696c8570f9af25d670dffebe3ae312b74ff065a17fbb20fa3 has inconsistent name: filename has 'netboxlabs-diode-netbox-plugin', but metadata has 'unknown' ERROR: Could not find a version that satisfies the requirement netboxlabs-diode-netbox-plugin==1.0.0 (from versions: 0.1.0, 0.2.0, 0.2.1, 0.3.0, 0.4.0, 0.4.1, 0.5.0, 0.5.1, 0.6.0, 1.0.0) ERROR: No matching distribution found for netboxlabs-diode-netbox-plugin==1.0.0

[mfiedorowicz]

I also cannot install the diode plugging but getting different error @mfiedorowicz , last week because 1.0.0 was not published but today looks like netbox-plugin.yaml file

• python is 3.10

• netbox 4.2.8 new clean install

• tried to install diode-netbox-plugin as per this guide

• is it possible that it is because in the netbox-plugin.yaml max version is 4.2.3 ?

• `version: 0.1
  package_name: netboxlabs-diode-netbox-plugin
  compatibility:

  • release: 1.0.0
    netbox_min: 4.2.3
    netbox_max: 4.2.3`

sudo pip install netboxlabs-diode-netbox-plugin=1.0.0 ERROR: Invalid requirement: 'netboxlabs-diode-netbox-plugin=1.0.0' Hint: = is not a valid operator. Did you mean == ? hnsi@hnsiai2:/opt/netbox$ sudo pip install netboxlabs-diode-netbox-plugin==1.0.0 Collecting netboxlabs-diode-netbox-plugin==1.0.0 Using cached netboxlabs_diode_netbox_plugin-1.0.0.tar.gz (40 kB) Installing build dependencies ... done Getting requirements to build wheel ... done Preparing metadata (pyproject.toml) ... done WARNING: Generating metadata for package netboxlabs-diode-netbox-plugin produced metadata for project name unknown. Fix your #egg=netboxlabs-diode-netbox-plugin fragments. Discarding https://files.pythonhosted.org/packages/3b/7e/070fdaeb26ae776ea36d11afc9fc050bc1b4739418e20e0cec0af1663185/netboxlabs_diode_netbox_plugin-1.0.0.tar.gz#sha256=3bd91bf3e8cd5a2696c8570f9af25d670dffebe3ae312b74ff065a17fbb20fa3 (from https://pypi.org/simple/netboxlabs-diode-netbox-plugin/) (requires-python:>=3.8): Requested unknown from https://files.pythonhosted.org/packages/3b/7e/070fdaeb26ae776ea36d11afc9fc050bc1b4739418e20e0cec0af1663185/netboxlabs_diode_netbox_plugin-1.0.0.tar.gz#sha256=3bd91bf3e8cd5a2696c8570f9af25d670dffebe3ae312b74ff065a17fbb20fa3 has inconsistent name: filename has 'netboxlabs-diode-netbox-plugin', but metadata has 'unknown' ERROR: Could not find a version that satisfies the requirement netboxlabs-diode-netbox-plugin==1.0.0 (from versions: 0.1.0, 0.2.0, 0.2.1, 0.3.0, 0.4.0, 0.4.1, 0.5.0, 0.5.1, 0.6.0, 1.0.0) ERROR: No matching distribution found for netboxlabs-diode-netbox-plugin==1.0.0

netbox-plugin.yaml doesn't affect installation with pip. In your error output it explicitly says to try pip install netboxlabs-diode-netbox-plugin==1.0.0

[mfiedorowicz]

Re: plugin installation issue, did you have previous version(s) of the netbox_diode_plugin installed on this NetBox instance? What does ./manage.py showmigrations netbox_diode_plugin say?

[sandyis]

Re: plugin installation issue, did you have previous version(s) of the netbox_diode_plugin installed on this NetBox instance? What does ./manage.py showmigrations netbox_diode_plugin say?

no it is a clean install of netbox in a python virtual env @mfiedorowicz

./manage.py showmigrations netbox_diode_plugin No installed app with label 'netbox_diode_plugin'.
this command didinot work and then i realized need to be netbox executable folder which in my case is some how one level down /opt/netbox/netbox

should below change in readme/install steps to cd /opt/netbox/netbox

Source the NetBox Python virtual environment:

cd /opt/netbox
source venv/bin/activate

[tobiasstein]

I guess I've got the same issue and I'll try to provide the requested information.
I started the installation with netbox v4.1.1, but when I remember correctly, netboxlabs-diode-netbox-plugin required v4.2.4, so I upgraded to netbox latest which was v4.3.0.

root@netbox:~#
root@netbox:~# cd /opt/netbox
root@netbox:/opt/netbox# source venv/bin/activate
(venv) root@netbox:/opt/netbox# cd netbox/
(venv) root@netbox:/opt/netbox/netbox# lsb_release -a
No LSB modules are available.
Distributor ID: Debian
Description:    Debian GNU/Linux 12 (bookworm)
Release:        12
Codename:       bookworm
(venv) root@netbox:/opt/netbox/netbox# git branch
* (HEAD detached at v4.3.0)
  master

(venv) root@netbox:/opt/netbox/netbox# ./manage.py showmigrations netbox_diode_plugin
netbox_diode_plugin
 [X] 0001_squashed_0005 (5 squashed migrations)

(venv) root@netbox:/opt/netbox/netbox# pip install netboxlabs-diode-netbox-plugin
Requirement already satisfied: netboxlabs-diode-netbox-plugin in /opt/netbox/venv/lib/python3.11/site-packages (1.0.0)
Requirement already satisfied: Brotli>=1.1.0 in /opt/netbox/venv/lib/python3.11/site-packages (from netboxlabs-diode-netbox-plugin) (1.1.0)
Requirement already satisfied: certifi>=2024.7.4 in /opt/netbox/venv/lib/python3.11/site-packages (from netboxlabs-diode-netbox-plugin) (2025.4.26)
Requirement already satisfied: grpcio>=1.68.1 in /opt/netbox/venv/lib/python3.11/site-packages (from netboxlabs-diode-netbox-plugin) (1.71.0)
Requirement already satisfied: protobuf>=5.28.1 in /opt/netbox/venv/lib/python3.11/site-packages (from netboxlabs-diode-netbox-plugin) (5.29.4)

(venv) root@netbox:/opt/netbox/netbox# pip list --outdated
Package                        Version Latest  Type
------------------------------ ------- ------- -----
click                          8.1.8   8.2.0   wheel
Django                         5.2     5.2.1   wheel
django-rich                    1.14.0  2.0.0   wheel
mkdocs-material                9.6.12  9.6.14  wheel
netboxlabs-diode-netbox-plugin 1.0.0   1.0.1   sdist
protobuf                       5.29.4  6.31.0  wheel
psycopg                        3.2.7   3.2.9   wheel
psycopg-c                      3.2.7   3.2.9   sdist
pyyaml_env_tag                 0.1     1.1     wheel
redis                          6.0.0   6.1.0   wheel
rq                             2.3.2   2.3.3   wheel
sentry-sdk                     2.27.0  2.28.0  wheel
setuptools                     66.1.1  80.4.0  wheel
strawberry-graphql             0.266.0 0.268.1 wheel
strawberry-graphql-django      0.58.0  0.59.1  wheel

(venv) root@netbox:/opt/netbox/netbox# pip install -U netboxlabs-diode-netbox-plugin
Requirement already satisfied: netboxlabs-diode-netbox-plugin in /opt/netbox/venv/lib/python3.11/site-packages (1.0.0)
Collecting netboxlabs-diode-netbox-plugin
  Downloading netboxlabs_diode_netbox_plugin-1.0.1.tar.gz (40 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
Requirement already satisfied: Brotli>=1.1.0 in /opt/netbox/venv/lib/python3.11/site-packages (from netboxlabs-diode-netbox-plugin) (1.1.0)
Requirement already satisfied: certifi>=2024.7.4 in /opt/netbox/venv/lib/python3.11/site-packages (from netboxlabs-diode-netbox-plugin) (2025.4.26)
Requirement already satisfied: grpcio>=1.68.1 in /opt/netbox/venv/lib/python3.11/site-packages (from netboxlabs-diode-netbox-plugin) (1.71.0)
Requirement already satisfied: protobuf>=5.28.1 in /opt/netbox/venv/lib/python3.11/site-packages (from netboxlabs-diode-netbox-plugin) (5.29.4)
Building wheels for collected packages: netboxlabs-diode-netbox-plugin
  Building wheel for netboxlabs-diode-netbox-plugin (pyproject.toml) ... done
  Created wheel for netboxlabs-diode-netbox-plugin: filename=netboxlabs_diode_netbox_plugin-1.0.1-py3-none-any.whl size=47834 sha256=77f7bc85386f81417881f5a6f1575acff605965fb2f86794ca7fc16e0be71f5
8
  Stored in directory: /root/.cache/pip/wheels/4a/23/ca/94f92187900c2a49607f6e2e3e03f4e3f468ab6aafc24b9e9c
Successfully built netboxlabs-diode-netbox-plugin 
Installing collected packages: netboxlabs-diode-netbox-plugin
  Attempting uninstall: netboxlabs-diode-netbox-plugin
    Found existing installation: netboxlabs-diode-netbox-plugin 1.0.0
    Uninstalling netboxlabs-diode-netbox-plugin-1.0.0:
      Successfully uninstalled netboxlabs-diode-netbox-plugin-1.0.0
Successfully installed netboxlabs-diode-netbox-plugin-1.0.1

(venv) root@netbox:/opt/netbox/netbox# ./manage.py migrate                                         
Operations to perform:
  Apply all migrations: account, auth, circuits, contenttypes, core, dcim, django_rq, extras, ipam, netbox_diode_plugin, sessions, social_django, taggit, tenancy, users, virtualization, vpn, wirel
ess
Running migrations:
  No migrations to apply.
  Your models in app(s): 'netbox_diode_plugin' have changes that are not yet reflected in a migration, and so won't be applied.
  Run 'manage.py makemigrations' to make new migrations, and then re-run 'manage.py migrate' to apply them.
(venv) root@netbox:/opt/netbox/netbox# ./manage.py makemigrations                                  
CommandError: This command is available for development purposes only. It will
NOT resolve any issues with missing or unapplied migrations. For assistance,
please post to the NetBox discussion forum on GitHub:
    https://github.com/netbox-community/netbox/discussions

(venv) root@netbox:/opt/netbox/netbox# ./manage.py migrate
Operations to perform:
  Apply all migrations: account, auth, circuits, contenttypes, core, dcim, django_rq, extras, ipam, netbox_diode_plugin, sessions, social_django, taggit, tenancy, users, virtualization, vpn, wirel
ess
Running migrations:
  No migrations to apply.
  Your models in app(s): 'netbox_diode_plugin' have changes that are not yet reflected in a migration, and so won't be applied.
  Run 'manage.py makemigrations' to make new migrations, and then re-run 'manage.py migrate' to apply them.

(venv) root@netbox:/opt/netbox/netbox# ./manage.py showmigrations netbox_diode_plugin
netbox_diode_plugin
 [X] 0001_squashed_0005 (5 squashed migrations)

[wessrow]

Also having the same issue.
This is on the recommended Netbox-version 4.2.3, fresh install with no previous netbox-diode-installation. Tested with both plugin version 1.0.0 which is the tested version, as well as with 1.0.1 that was released a few days ago:

(venv) unit@47c6a932d623:/opt/netbox/netbox$ cd /opt/netbox/netbox && ./manage.py migrate netbox_diode_plugin

🧬 loaded config '/etc/netbox/config/configuration.py'
🧬 loaded config '/etc/netbox/config/extra.py'
🧬 loaded config '/etc/netbox/config/logging.py'
🧬 loaded config '/etc/netbox/config/plugins.py'
Operations to perform:
  Apply all migrations: netbox_diode_plugin
Running migrations:
  No migrations to apply.
  Your models in app(s): 'netbox_diode_plugin' have changes that are not yet reflected in a migration, and so won't be applied.
  Run 'manage.py makemigrations' to make new migrations, and then re-run 'manage.py migrate' to apply them.
(venv) unit@47c6a932d623:/opt/netbox/netbox$
(venv) unit@47c6a932d623:/opt/netbox/netbox$ cd /opt/netbox/netbox && ./manage.py makemigrations
🧬 loaded config '/etc/netbox/config/configuration.py'
🧬 loaded config '/etc/netbox/config/extra.py'
🧬 loaded config '/etc/netbox/config/logging.py'
🧬 loaded config '/etc/netbox/config/plugins.py'
CommandError: This command is available for development purposes only. It will
NOT resolve any issues with missing or unapplied migrations. For assistance,
please post to the NetBox discussion forum on GitHub:
    https://github.com/netbox-community/netbox/discussions
(venv) unit@47c6a932d623:/opt/netbox/netbox$ cd /opt/netbox/netbox && ./manage.py showmigrations netbox_diode_plugin
🧬 loaded config '/etc/netbox/config/configuration.py'
🧬 loaded config '/etc/netbox/config/extra.py'
🧬 loaded config '/etc/netbox/config/logging.py'
🧬 loaded config '/etc/netbox/config/plugins.py'
netbox_diode_plugin
 [X] 0001_squashed_0005 (5 squashed migrations)

[mfiedorowicz]

Thanks for all reports, we will investigate it soon and keep you updated

[wessrow]

I also did some further testing on this to see if there were previous requirements through the upgrade path missing:

Starting from NB 4.1.0, installing plugin v0.4.0 and working myself up through:

NB: 4.1.0, Plugin: 0.4.0 - Migrations OK
NB: 4.2.3, Plugin: 0.5.0 - Migrations OK
NB: 4.2.3, Plugin: 0.6.0 - Migrations OK
NB: 4.2.3, Plugin: 1.0.0 - No migrations found, and the settings under the Plugin view disappears.

Even when upgrading and keeping the settings throughout, it ends up in the same place, automatic migration doesn't run - and manual results in:

unit@f9f9b41424e5:/opt/netbox/netbox$ source ../venv/bin/activate
(venv) unit@f9f9b41424e5:/opt/netbox/netbox$ cd /opt/netbox/netbox && ./manage.py migrate netbox_diode_plugin
🧬 loaded config '/etc/netbox/config/configuration.py'
🧬 loaded config '/etc/netbox/config/extra.py'
🧬 loaded config '/etc/netbox/config/logging.py'
🧬 loaded config '/etc/netbox/config/plugins.py'
Operations to perform:
  Apply all migrations: netbox_diode_plugin
Running migrations:
  No migrations to apply.
  Your models in app(s): 'netbox_diode_plugin' have changes that are not yet reflected in a migration, and so won't be applied.
  Run 'manage.py makemigrations' to make new migrations, and then re-run 'manage.py migrate' to apply them.
(venv) unit@f9f9b41424e5:/opt/netbox/netbox$

So something in the migration-script for 0.6.0 to 1.0.0 doesn't seem to work as intended.

[mfiedorowicz]

1.0.0 have all old migrations squashed into one and replace them, hence nothing to apply (update: when migrating from 0.6.0)

[LeighBennettCP]

I have the same issue today. I came across this trying to troubleshoot why I do not have a 'Ingestion Logs' option within the Netbox GUI. I seem to have everything else working now such as Netbox/Diode/Orb-agent.

All I see is:
Diode > Settings
Diode > Client Credentials

I was retracing my steps of the plugin installation and encountered this.

(venv) [root@host netbox]# cd /opt/netbox/netbox
./manage.py migrate netbox_diode_plugin
Operations to perform:
  Apply all migrations: netbox_diode_plugin
Running migrations:
  No migrations to apply.
  Your models in app(s): 'netbox_diode_plugin' have changes that are not yet reflected in a migration, and so won't be applied.
  Run 'manage.py makemigrations' to make new migrations, and then re-run 'manage.py migrate' to apply them.
(venv) [root@host netbox]#

could this be the reason why the Diode > Ingestion Logs option seems to be missing?

Netbox version 4.2.4

[joeladria]

@LeighBennettCP the Ingestion Logs function seems to have been removed. I can only speculate that maybe this will be packaged as part of the Server component or maybe as part of NetBox Assurance? But somewhat difficult to understand what's going on with the service without it!
v0.6.0...v1.1.0

[mfiedorowicz]

Ingestion logs have been removed in diode-netbox-plugin 1.0.0, this plugin's main purposes are API and settings + client credentials. Ingested / reconciled data viewer will be added a little bit later.

[toystorykiwi]

i'm facing the exact the same problem with NetBox Community v4.2.5-Docker-3.2.0 and Diode Plugin 1.3
When i run the command
docker compose exec netbox python3 manage.py migrate

i got the the same output

🧬 loaded config '/etc/netbox/config/configuration.py' 🧬 loaded config '/etc/netbox/config/extra.py' 🧬 loaded config '/etc/netbox/config/logging.py' 🧬 loaded config '/etc/netbox/config/plugins.py' Operations to perform: Apply all migrations: account, auth, circuits, contenttypes, core, dcim, django_rq, extras, ipam, netbox_bgp, netbox_diode_plugin, netbox_topology_views, sessions, social_django, taggit, tenancy, users, virtualization, vpn, wireless Running migrations: No migrations to apply. Your models in app(s): 'netbox_diode_plugin' have changes that are not yet reflected in a migration, and so won't be applied. Run 'manage.py makemigrations' to make new migrations, and then re-run 'manage.py migrate' to apply them.

Do you have any update or suggetion how i could fix it?