mirror of
https://github.com/open-webui/docs.git
synced 2026-04-05 14:58:45 +07:00
28 lines
1017 B
Markdown
28 lines
1017 B
Markdown
# Updating with Python
|
|
|
|
To update your locally installed **Open-WebUI** package to the latest version using `pip`, follow these simple steps:
|
|
|
|
```bash
|
|
pip install -U open-webui
|
|
```
|
|
|
|
The `-U` (or `--upgrade`) flag ensures that `pip` upgrades the package to the latest available version.
|
|
|
|
After upgrading, restart the server and verify it starts correctly:
|
|
|
|
```bash
|
|
open-webui serve
|
|
```
|
|
|
|
:::warning Multi-Worker Environments
|
|
If you run Open WebUI with `UVICORN_WORKERS > 1` (e.g., in a production environment), you **MUST** ensure the update migration runs on a single worker first to prevent database schema corruption.
|
|
|
|
**Steps for proper update:**
|
|
1. Update `open-webui` using `pip`.
|
|
2. Start the application with `UVICORN_WORKERS=1` environment variable set.
|
|
3. Wait for the application to fully start and complete migrations.
|
|
4. Stop and restart the application with your desired number of workers.
|
|
:::
|
|
|
|
For version pinning, rollback, and backup procedures, see the [full update guide](/getting-started/updating).
|