Open WebUI upgrade fails from Legacy to UV - missing 'mkdir -p /usr/share/zsh/site-functions' and hardcode python version #1986

Closed
opened 2026-02-05 03:12:33 +03:00 by OVERLORD · 4 comments
Owner

Originally created by @flewis88 on GitHub (Nov 12, 2025).

Have you read and understood the above guidelines?

yes

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

OpenWebUI

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

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/openwebui.sh)"

⚙️ What settings are you using?

  • Default Settings
  • Advanced Settings

🖥️ Which Linux distribution are you using?

Debian 13

📈 Which Proxmox version are you on?

pve-manager/9.0.11/3bf5476b8a4699e2 (running kernel: 6.14.11-4-pve)

📝 Provide a clear and concise description of the issue.

Upgrade script fails due to

  1. missing directory /usr/share/zsh/site-functions
  2. command '$STD uv tool install --python $PYTHON_VERSION open-webui[all]' doesn't resolve the value of PYTHON_VERSION

🔄 Steps to reproduce the issue.

run bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/openwebui.sh)"

Paste the full error output (if available).


/ __ ____ ___ ____ | | / /__ / /_ / / / / /
/ / / / __ / _ / __ \ | | /| / / _ / __ / / / // /
/ /
/ / // / __/ / / / | |/ |/ / __/ // / // // /
_
/ ./_// // |/|/_/./_//
/
/

💡 Legacy installation detected — migrating to uv based install...
✔️ Stopped Service
✔️ Created Backup
✔️ Removed legacy installation
Installing Python 3.12 via uvcpython-3.12.12-linux-x86_64-gnu (download) ------------------------------ 0 B/31.78 MiB
Installed Python 3.12.12 in 968ms

  • cpython-3.12.12-linux-x86_64-gnu (python3.12)
    warning: /root/.local/bin is not on your PATH. To use installed Python executables, run export PATH="/root/.local/bin:$PATH" or uv python update-shell.
    ✔️ Python 3.12 installed
    ✔️ Setup uv 0.9.8
    error: the following required arguments were not provided:

Usage: uv tool install --python

For more information, try '--help'.

[ERROR] in line 45: exit code 0: while executing command $STD uv tool install --python $PYTHON_VERSION open-webui[all]

🖼️ Additional context (optional).

To resolve, the issue, do the following:

  1. run 'mkdir -p /usr/share/zsh/site-functions' prior to the script
  2. modify script from '$STD uv tool install --python $PYTHON_VERSION open-webui[all]' to '$STD uv tool install --python 3.12 open-webui[all]'
  3. add 'export PATH="/root/.local/bin:$PATH"' to the script to allow python executables
Originally created by @flewis88 on GitHub (Nov 12, 2025). ### ✅ Have you read and understood the above guidelines? yes ### 📜 What is the name of the script you are using? OpenWebUI ### 📂 What was the exact command used to execute the script? bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/openwebui.sh)" ### ⚙️ What settings are you using? - [x] Default Settings - [ ] Advanced Settings ### 🖥️ Which Linux distribution are you using? Debian 13 ### 📈 Which Proxmox version are you on? pve-manager/9.0.11/3bf5476b8a4699e2 (running kernel: 6.14.11-4-pve) ### 📝 Provide a clear and concise description of the issue. Upgrade script fails due to 1. missing directory /usr/share/zsh/site-functions 2. command '$STD uv tool install --python $PYTHON_VERSION open-webui[all]' doesn't resolve the value of PYTHON_VERSION ### 🔄 Steps to reproduce the issue. run bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/openwebui.sh)" ### ❌ Paste the full error output (if available). ____ _ __ __ __ ______ / __ \____ ___ ____ | | / /__ / /_ / / / / _/ / / / / __ \/ _ \/ __ \ | | /| / / _ \/ __ \/ / / // / / /_/ / /_/ / __/ / / / | |/ |/ / __/ /_/ / /_/ // / \____/ .___/\___/_/ /_/ |__/|__/\___/_.___/\____/___/ /_/ 💡 Legacy installation detected — migrating to uv based install... ✔️ Stopped Service ✔️ Created Backup ✔️ Removed legacy installation ⏳ Installing Python 3.12 via uvcpython-3.12.12-linux-x86_64-gnu (download) ------------------------------ 0 B/31.78 MiB Installed Python 3.12.12 in 968ms + cpython-3.12.12-linux-x86_64-gnu (python3.12) warning: `/root/.local/bin` is not on your PATH. To use installed Python executables, run `export PATH="/root/.local/bin:$PATH"` or `uv python update-shell`. ✔️ Python 3.12 installed ✔️ Setup uv 0.9.8 error: the following required arguments were not provided: <PACKAGE> Usage: uv tool install --python <PYTHON> <PACKAGE> For more information, try '--help'. [ERROR] in line 45: exit code 0: while executing command $STD uv tool install --python $PYTHON_VERSION open-webui[all] ### 🖼️ Additional context (optional). To resolve, the issue, do the following: 1. run 'mkdir -p /usr/share/zsh/site-functions' prior to the script 2. modify script from '$STD uv tool install --python $PYTHON_VERSION open-webui[all]' to '$STD uv tool install --python 3.12 open-webui[all]' 3. add 'export PATH="/root/.local/bin:$PATH"' to the script to allow python executables
OVERLORD added the not a script issuebug labels 2026-02-05 03:12:33 +03:00
Author
Owner

@flewis88 commented on GitHub (Nov 12, 2025):

Working script, though 2 inclusions of export PATH="/root/.local/bin:$PATH" may be extraneous

openwebui.sh

@flewis88 commented on GitHub (Nov 12, 2025): Working script, though 2 inclusions of export PATH="/root/.local/bin:$PATH" may be extraneous [openwebui.sh](https://github.com/user-attachments/files/23491517/openwebui.sh)
Author
Owner

@MickLesk commented on GitHub (Nov 12, 2025):

not directly an script issue, we aware all users zu use ssh / bash instead of zsh fish sh or something other terminal variant.

@MickLesk commented on GitHub (Nov 12, 2025): not directly an script issue, we aware all users zu use ssh / bash instead of zsh fish sh or something other terminal variant.
Author
Owner

@flewis88 commented on GitHub (Nov 12, 2025):

not directly an script issue, we aware all users zu use ssh / bash instead of zsh fish sh or something other terminal variant.

I was running it directly in the browser console via Web UI, and if the folder is created but python version not hardcoded, it will corrupt your install. I presume as helper scripts they would be ideally supporting the standard web console too? I presume it can be written to be shell agnostic?

Note also there is an inconsistency where in one place a python version variable is used, and in the other it is hardcoded in the command. Only the one with the variable fails.

Appreciate your contribution

@flewis88 commented on GitHub (Nov 12, 2025): > not directly an script issue, we aware all users zu use ssh / bash instead of zsh fish sh or something other terminal variant. I was running it directly in the browser console via Web UI, and if the folder is created but python version not hardcoded, it will corrupt your install. I presume as helper scripts they would be ideally supporting the standard web console too? I presume it can be written to be shell agnostic? Note also there is an inconsistency where in one place a python version variable is used, and in the other it is hardcoded in the command. Only the one with the variable fails. Appreciate your contribution
Author
Owner

@Externalnet commented on GitHub (Nov 12, 2025):

I get this when I try to update, is this the same issue as described here ?

Processing triggers for libc-bin (2.36-9+deb12u10) ...
Setup uv 0.9.8/dev/fd/63: line 4525: /usr/share/zsh/site-functions/_uv: No such file or directory
Installing Python 3.12 via uvcpython-3.12.12-linux-x86_64-gnu (download) ------------------------------ 0 B/31.78 MiB
Installed Python 3.12.12 in 850ms

  • cpython-3.12.12-linux-x86_64-gnu (python3.12)
    warning: /root/.local/bin is not on your PATH. To use installed Python executables, run export PATH="/root/.local/bin:$PATH" or uv python update-shell.
    ✔️ Python 3.12 installed
    ✔️ Setup uv 0.9.8
    error: the following required arguments were not provided:

Usage: uv tool install --python

For more information, try '--help'.

[ERROR] in line 45: exit code 0: while executing command $STD uv tool install --python $PYTHON_VERSION open-webui[all]

@Externalnet commented on GitHub (Nov 12, 2025): I get this when I try to update, is this the same issue as described here ? Processing triggers for libc-bin (2.36-9+deb12u10) ... ⏳ Setup uv 0.9.8/dev/fd/63: line 4525: /usr/share/zsh/site-functions/_uv: No such file or directory ⏳ Installing Python 3.12 via uvcpython-3.12.12-linux-x86_64-gnu (download) ------------------------------ 0 B/31.78 MiB Installed Python 3.12.12 in 850ms + cpython-3.12.12-linux-x86_64-gnu (python3.12) warning: `/root/.local/bin` is not on your PATH. To use installed Python executables, run `export PATH="/root/.local/bin:$PATH"` or `uv python update-shell`. ✔️ Python 3.12 installed ✔️ Setup uv 0.9.8 error: the following required arguments were not provided: <PACKAGE> Usage: uv tool install --python <PYTHON> <PACKAGE> For more information, try '--help'. [ERROR] in line 45: exit code 0: while executing command $STD uv tool install --python $PYTHON_VERSION open-webui[all]
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/ProxmoxVE#1986