Error AtlasError Documentation and Resolution
Back to searchMore pip errors

pip

pip refused to modify an externally managed Python environment

error: externally-managed-environment

pip refused to install into the current Python environment because the environment is externally managed by the operating system or distributor tooling.

externally-managed-environmentpackage managers

Observed message

error: externally-managed-environment

Why it happens

  • The current Python installation is marked as externally managed.
  • pip is being used directly against a system-managed interpreter.
  • The host platform expects packages to be installed through its own package-management flow.

How to fix it

  1. Use a virtual environment for project-specific package installs.
  2. Use a Python installation that is intended for user-managed packages.
  3. Only use break-system-packages style overrides if you fully understand the platform risk.

Official reference

pip documentation: pip uninstall

Related errors

No matching distribution foundpip cannot find a compatible package versionResolutionImpossiblepip cannot resolve conflicting dependency requirementsrequires <package>, which is not installedpip check found a missing required packagerequires WebOb, which is not installedpip check found a required package that is not installed

Explore more

pipBrowse more pip errorspackage managersBrowse more package managers errors
pip externally-managed-environment: causes and fixes | Error Atlas