ModuleNotFoundError: No module named 'extras.plugins'

[stefanschumacheratwork]

NetBox Edition

NetBox Community

NetBox Version

v4.3.7

Python Version

3.10

Steps to Reproduce

Hello

I want to update my installation from 4.3.7 to 4.4.4. I have executed the following steps:

git fetch --tags
git checkout v.4.4.4
source venv/bin/activate
/opt/netbox/upgrade.sh

It then complained of missing plugins configured in /opt/netbox/netbox/netbox/configuration. I copied them, changed the names and added them to local_requirements.txt. It seems to work - was this the right choice?

Successfully installed asyncssh-2.21.1 dnspython-2.8.0 hier-config-2.3.1 netbox-acls-1.9.1 netbox-bgp-0.17.0 netbox-config-diff-2.11.0 netbox-dns-0.17.0 netbox-floorplan-plugin-0.8.0 netbox-interface-synchronization-4.1.7 netbox-inventory-2.4.0 netbox-qrcode-0.0.19 netbox-reorder-rack-1.1.4 netbox-secrets-2.3.4 netbox-topology-views-4.4.0 netutils-1.12.0 pycryptodome-3.23.0 pyuwsgi-2.0.30 qrcode-8.2 scrapli-2024.7.30 scrapli-cfg-2024.7.30 scrapli-community-2024.7.30 types-pyyaml-6.0.12.20250915

Expected Behavior

The Migration should finish and I should be able to use Netbox v.4.4.4

Observed Behavior

Applying database migrations (python3 netbox/manage.py migrate)...
Traceback (most recent call last):
File "/opt/netbox/netbox/manage.py", line 10, in
execute_from_command_line(sys.argv)
File "/opt/netbox/venv/lib/python3.11/site-packages/django/core/management/init.py", line 442, in execute_from_command_line
utility.execute()
File "/opt/netbox/venv/lib/python3.11/site-packages/django/core/management/init.py", line 436, in execute
self.fetch_command(subcommand).run_from_argv(self.argv)
File "/opt/netbox/venv/lib/python3.11/site-packages/django/core/management/base.py", line 408, in run_from_argv
parser = self.create_parser(argv[0], argv[1])
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/netbox/venv/lib/python3.11/site-packages/django/core/management/base.py", line 371, in create_parser
self.add_arguments(parser)
File "/opt/netbox/venv/lib/python3.11/site-packages/django/core/management/commands/migrate.py", line 45, in add_arguments
choices=tuple(connections),
^^^^^^^^^^^^^^^^^^
File "/opt/netbox/venv/lib/python3.11/site-packages/django/utils/connection.py", line 73, in iter
return iter(self.settings)
^^^^^^^^^^^^^
File "/opt/netbox/venv/lib/python3.11/site-packages/django/utils/functional.py", line 47, in get
res = instance.dict[self.name] = self.func(instance)
^^^^^^^^^^^^^^^^^^^
File "/opt/netbox/venv/lib/python3.11/site-packages/django/utils/connection.py", line 45, in settings
self._settings = self.configure_settings(self._settings)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/netbox/venv/lib/python3.11/site-packages/django/db/utils.py", line 148, in configure_settings
databases = super().configure_settings(databases)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/netbox/venv/lib/python3.11/site-packages/django/utils/connection.py", line 50, in configure_settings
settings = getattr(django_settings, self.settings_name)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/netbox/venv/lib/python3.11/site-packages/django/conf/init.py", line 81, in getattr
self._setup(name)
File "/opt/netbox/venv/lib/python3.11/site-packages/django/conf/init.py", line 68, in _setup
self._wrapped = Settings(settings_module)
^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/netbox/venv/lib/python3.11/site-packages/django/conf/init.py", line 166, in init
mod = importlib.import_module(self.SETTINGS_MODULE)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/lib/python3.11/importlib/init.py", line 126, in import_module
return _bootstrap._gcd_import(name[level:], package, level)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "", line 1206, in _gcd_import
File "", line 1178, in _find_and_load
File "", line 1149, in _find_and_load_unlocked
File "", line 690, in _load_unlocked
File "", line 940, in exec_module
File "", line 241, in _call_with_frames_removed
File "/opt/netbox/netbox/netbox/settings.py", line 862, in
raise e
File "/opt/netbox/netbox/netbox/settings.py", line 855, in
plugin = importlib.import_module(plugin_name)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/lib/python3.11/importlib/init.py", line 126, in import_module
return _bootstrap._gcd_import(name[level:], package, level)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "", line 1206, in _gcd_import
File "", line 1178, in _find_and_load
File "", line 1149, in _find_and_load_unlocked
File "", line 690, in _load_unlocked
File "", line 940, in exec_module
File "", line 241, in _call_with_frames_removed
File "/opt/netbox/venv/lib/python3.11/site-packages/netbox_dns/init.py", line 1, in
from extras.plugins import PluginConfig
ModuleNotFoundError: No module named 'extras.plugins'

[pheus]

Hi there — thanks for opening the issue and for sharing the traceback.

From the stack trace, the error is raised inside a third‑party plugin rather than NetBox core:

ModuleNotFoundError: No module named 'extras.plugins'
...
File ".../site-packages/netbox_dns/__init__.py", line 1, in <module>
    from extras.plugins import PluginConfig

In NetBox v4 the plugin API moved from extras.plugins to netbox.plugins, so any plugin still importing from extras.plugins isn’t v4‑compatible. See the v4 migration notes:
https://netboxlabs.com/docs/netbox/plugins/development/migration-v4/

It also appears you’re using the deprecated netbox-dns plugin. The actively maintained successor is netbox-plugin-dns. Please replace the old package with the new one and follow that project’s README for installation and upgrades.