Paperless-NGX Update script failed #1497

Closed
opened 2026-02-05 01:20:30 +03:00 by OVERLORD · 2 comments
Owner

Originally created by @MarkMSP on GitHub (Aug 20, 2025).

Have you read and understood the above guidelines?

yes

📜 What is the name of the script you are using?

update.sh

📂 What was the exact command used to execute the script?

bash update.sh

⚙️ What settings are you using?

  • Default Settings
  • Advanced Settings

🖥️ Which Linux distribution are you using?

Debian 12

📝 Provide a clear and concise description of the issue.

The update script failed to update to version 2.18.1 with error. I think it is an python problem. Can someone help ? THX

🔄 Steps to reproduce the issue.

Update Debian 12

Make paperless update with script bash update.sh

Paste the full error output (if available).

✔️ Stopped all Paperless-ngx Services
Updating to v2.18.1error: 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.

[ERROR] in line 61: exit code 0: while executing command $STD pip install -r requirements.txt

🖼️ Additional context (optional).

I update python3 with full version of this.

Originally created by @MarkMSP on GitHub (Aug 20, 2025). ### ✅ Have you read and understood the above guidelines? yes ### 📜 What is the name of the script you are using? update.sh ### 📂 What was the exact command used to execute the script? bash update.sh ### ⚙️ What settings are you using? - [x] Default Settings - [ ] Advanced Settings ### 🖥️ Which Linux distribution are you using? Debian 12 ### 📝 Provide a clear and concise description of the issue. The update script failed to update to version 2.18.1 with error. I think it is an python problem. Can someone help ? THX ### 🔄 Steps to reproduce the issue. Update Debian 12 Make paperless update with script bash update.sh ### ❌ Paste the full error output (if available). ✔️ Stopped all Paperless-ngx Services ⏳ Updating to v2.18.1error: 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. [ERROR] in line 61: exit code 0: while executing command $STD pip install -r requirements.txt ### 🖼️ Additional context (optional). I update python3 with full version of this.
OVERLORD added the bug label 2026-02-05 01:20:30 +03:00
Author
Owner

@MickLesk commented on GitHub (Aug 20, 2025):

#555

@MickLesk commented on GitHub (Aug 20, 2025): #555
Author
Owner

@MarkMSP commented on GitHub (Aug 20, 2025):

THX this fixed the problem

rm -rf /usr/lib/python3.*/EXTERNALLY-MANAGED

Greets

@MarkMSP commented on GitHub (Aug 20, 2025): THX this fixed the problem rm -rf /usr/lib/python3.*/EXTERNALLY-MANAGED Greets
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/ProxmoxVE#1497