Paperless-NGX Install Script collides with new pip guidelines #1121

Closed
opened 2026-02-04 23:11:35 +03:00 by OVERLORD · 1 comment
Owner

Originally created by @eschie22 on GitHub (Jun 19, 2025).

Have you read and understood the above guidelines?

yes

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

Paperless-NGX

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

Copying the https://github.com/community-scripts/ProxmoxVE/blob/main/install/paperless-ngx-install.sh to local pc and run it as bash (./script.bash)

⚙️ 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.

In the Install Script of Paperless NGX (https://github.com/community-scripts/ProxmoxVE/blob/main/install/paperless-ngx-install.sh) you are trying to install some Python Packages via pip install. However since Debian 12 this isnt possible anymore ( told me ChatGPT). According to ChatGPT we should either use a venv for our Python environment or we can use --break-system-packages, but this is not recommended.

It would be nice if you can find a proper Solution

🔄 Steps to reproduce the issue.

pip install --upgrade pip

Paste the full error output (if available).

pip install --upgrade pip
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
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.

🖼️ Additional context (optional).

No response

Originally created by @eschie22 on GitHub (Jun 19, 2025). ### ✅ Have you read and understood the above guidelines? yes ### 📜 What is the name of the script you are using? Paperless-NGX ### 📂 What was the exact command used to execute the script? Copying the https://github.com/community-scripts/ProxmoxVE/blob/main/install/paperless-ngx-install.sh to local pc and run it as bash (./script.bash) ### ⚙️ 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. In the Install Script of Paperless NGX (https://github.com/community-scripts/ProxmoxVE/blob/main/install/paperless-ngx-install.sh) you are trying to install some Python Packages via pip install. However since Debian 12 this isnt possible anymore ( told me ChatGPT). According to ChatGPT we should either use a venv for our Python environment or we can use --break-system-packages, but this is not recommended. It would be nice if you can find a proper Solution ### 🔄 Steps to reproduce the issue. pip install --upgrade pip ### ❌ Paste the full error output (if available). pip install --upgrade pip 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 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. ### 🖼️ Additional context (optional). _No response_
OVERLORD added the bug label 2026-02-04 23:11:35 +03:00
Author
Owner

@MickLesk commented on GitHub (Jun 19, 2025):

Local deployment doesnt work! Thats an full Script Pipeline with more then the Install -sh

@MickLesk commented on GitHub (Jun 19, 2025): Local deployment doesnt work! Thats an full Script Pipeline with more then the Install -sh
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/ProxmoxVE#1121