Updating the 360 Monitoring agent fails: error externally-managed-environment

Symptoms

• Installing or updating agent360 fails with the error:

# pip install agent360 --upgrade
error: externally-managed-environment
This environment is externally managed.
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.

• The server is running Ubuntu 24.04 - Debian 13.

Cause

This is a change in how newer Ubuntu/Debian releases handle Python packages.

These versions implement PEP 668, which marks the system Python as externally managed and blocks pip from installing or upgrading packages system-wide. This protects packages managed by APT from being broken by pip.

Resolution

Execute the update command with the --break-system-packages flag:

# pip install agent360 --upgrade --break-system-packages