externally managed environment

A marker, defined in PEP 668, that tells pip a Python belongs to the operating system or another package manager and must not be changed with pip.

Overriding it with --break-system-packages can break operating system tools that depend on the system Python.

In more detail

On recent Debian, Ubuntu, Fedora and Homebrew Pythons, pip install outside a virtual environment stops with error: externally-managed-environment. The right answer is a virtual environment, the distribution's own package, or pipx for command-line tools. The --break-system-packages flag overrides it and is exactly as risky as it sounds.

Related terms

Taught in

References