Docker/Portainer install fails

  • Y] I have searched the existing open and closed issues


  • Date | Wed Dec 27 09:59:59 EST 2023
  • Bug report | d974e242-9339-477c-9c94-fb614a3fa65d
  • DietPi version | v8.25.1 (MichaIng/master)
  • Image creator |
  • Pre-image |
  • Hardware | Native PC (x86_64) (ID=21)
  • Kernel version | Linux 617NUC 6.1.0-16-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.67-1 (2023-12-12) x86_64 GNU/Linux
  • Distro | bookworm (ID=7)
  • Command | pip3 uninstall -y docker-compose
  • Exit code | 1
  • Software title | DietPi-Software

Steps to reproduce:

  1. … Adding Docker and Portainer via Dietpi-software

Expected behaviour:

  • … Docker should install

Actual behaviour:

  • … Install fails

Extra details:

Additional logs:

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

    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.

Why opening very same question on GitHub as well? It’s not going to speed up things. Just causing us double efforts to manage both.

I created it in both places since that was what the instructions in the console seemed to indicate was the correct way to proceed.

Issue solved. We either need to skip uninstalling the (old) Python module on Bookworm if Python was not installed via dietpi-software, of pass the --break-system-packages flag with the particular pip3 call.