[GH-ISSUE #570] Installation following the documentation not possible on Debian 12 Bookworm #384

New issue

Open

opened 2026-02-26 10:31:11 +03:00 by kerem · 1 comment

kerem commented

2026-02-26 10:31:11 +03:00

Owner

Originally created by @etkaar on GitHub (Dec 29, 2024).
Original GitHub issue: https://github.com/nsupdate-info/nsupdate.info/issues/570

An installation on Debian 12 Bookworm following the documentation is not possible. Using pip install -r requirements.d/prod.txt will cause following error message:

root@nsupdate:~# pip install -r requirements.d/prod.txt
error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.
    
    If you wish to install a non-Debian-packaged Python package,
    create a virtual environment using python3 -m venv path/to/venv.
    Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
    sure you have python3-full installed.
    
    If you wish to install a non-Debian packaged Python application,
    it may be easiest to use pipx install xyz, which will manage a
    virtual environment for you. Make sure you have pipx installed.
    
    See /usr/share/doc/python3.11/README.venv for more information.

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.

Using pip install nsupdate will lead to the same error message:

root@nsupdate:~# pip install nsupdate
error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.
    
    If you wish to install a non-Debian-packaged Python package,
    create a virtual environment using python3 -m venv path/to/venv.
    Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
    sure you have python3-full installed.
    
    If you wish to install a non-Debian packaged Python application,
    it may be easiest to use pipx install xyz, which will manage a
    virtual environment for you. Make sure you have pipx installed.
    
    See /usr/share/doc/python3.11/README.venv for more information.

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.

Finally using pipx install nsupdate will cause following error message:

root@nsupdate:~# pipx install nsupdate
Note: Dependent package 'netaddr' contains 1 apps
  - netaddr
Note: Dependent package 'django' contains 1 apps
  - django-admin
Note: Dependent package 'sqlparse' contains 1 apps
  - sqlformat
Note: Dependent package 'charset-normalizer' contains 1 apps
  - normalizer

No apps associated with package nsupdate. Try again with '--include-deps' to include apps of dependent packages, which are listed above. If you are attempting to
install a library, pipx should not be used. Consider using pip or a similar tool instead."

Originally created by @etkaar on GitHub (Dec 29, 2024). Original GitHub issue: https://github.com/nsupdate-info/nsupdate.info/issues/570 An installation on Debian 12 Bookworm following the [documentation](https://nsupdateinfo.readthedocs.io/en/latest/admin.html#installation-for-production) is not possible. Using `pip install -r requirements.d/prod.txt` will cause following error message: ``` root@nsupdate:~# pip install -r requirements.d/prod.txt error: externally-managed-environment × This environment is externally managed ╰─> To install Python packages system-wide, try apt install python3-xyz, where xyz is the package you are trying to install. If you wish to install a non-Debian-packaged Python package, create a virtual environment using python3 -m venv path/to/venv. Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make sure you have python3-full installed. If you wish to install a non-Debian packaged Python application, it may be easiest to use pipx install xyz, which will manage a virtual environment for you. Make sure you have pipx installed. See /usr/share/doc/python3.11/README.venv for more information. note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages. hint: See PEP 668 for the detailed specification. ``` Using `pip install nsupdate` will lead to the same error message: ``` root@nsupdate:~# pip install nsupdate error: externally-managed-environment × This environment is externally managed ╰─> To install Python packages system-wide, try apt install python3-xyz, where xyz is the package you are trying to install. If you wish to install a non-Debian-packaged Python package, create a virtual environment using python3 -m venv path/to/venv. Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make sure you have python3-full installed. If you wish to install a non-Debian packaged Python application, it may be easiest to use pipx install xyz, which will manage a virtual environment for you. Make sure you have pipx installed. See /usr/share/doc/python3.11/README.venv for more information. note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages. hint: See PEP 668 for the detailed specification. ``` Finally using `pipx install nsupdate` will cause following error message: ``` root@nsupdate:~# pipx install nsupdate Note: Dependent package 'netaddr' contains 1 apps - netaddr Note: Dependent package 'django' contains 1 apps - django-admin Note: Dependent package 'sqlparse' contains 1 apps - sqlformat Note: Dependent package 'charset-normalizer' contains 1 apps - normalizer No apps associated with package nsupdate. Try again with '--include-deps' to include apps of dependent packages, which are listed above. If you are attempting to install a library, pipx should not be used. Consider using pip or a similar tool instead." ```

kerem commented

2026-02-26 10:31:12 +03:00

Author

Owner

@ThomasWaldmann commented on GitHub (Dec 29, 2024):

Maybe rather work:

as a user (not root)
in a python virtual env

See top of the page there:

https://nsupdateinfo.readthedocs.io/en/latest/admin.html#administrating-the-service

Also, guess using git master branch would be better for production, the last release was quite a while back. But you can do first experiments also with the pip package.

@ThomasWaldmann commented on GitHub (Dec 29, 2024): Maybe rather work: - as a user (not root) - in a python virtual env See top of the page there: https://nsupdateinfo.readthedocs.io/en/latest/admin.html#administrating-the-service Also, guess using git master branch would be better for production, the last release was quite a while back. But you can do first experiments also with the pip package.