mirror of
https://github.com/open-webui/docs
synced 2025-06-13 18:09:49 +00:00
Update intro.mdx
This commit is contained in:
parent
bca9882511
commit
20ebb874fd
@ -95,6 +95,40 @@ docker run -d --name watchtower --restart unless-stopped -v /var/run/docker.sock
|
|||||||
|
|
||||||
## Manual Installation
|
## Manual Installation
|
||||||
|
|
||||||
|
There are two main ways to install and run Open WebUI: using the `uv` runtime manager or Python's `pip`. While both methods are effective, **we strongly recommend using `uv`** as it simplifies environment management and minimizes potential conflicts.
|
||||||
|
|
||||||
|
### Installation with `uv` (Recommended)
|
||||||
|
|
||||||
|
The `uv` runtime manager ensures seamless Python environment management for applications like Open WebUI. Follow these steps to get started:
|
||||||
|
|
||||||
|
#### 1. Install `uv`
|
||||||
|
|
||||||
|
Pick the appropriate installation command for your operating system:
|
||||||
|
|
||||||
|
- **macOS/Linux**:
|
||||||
|
```bash
|
||||||
|
curl -LsSf https://astral.sh/uv/install.sh | sh
|
||||||
|
```
|
||||||
|
|
||||||
|
- **Windows**:
|
||||||
|
```powershell
|
||||||
|
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 2. Run Open WebUI
|
||||||
|
|
||||||
|
Once `uv` is installed, running Open WebUI is a breeze. Use the command below, ensuring to set the `DATA_DIR` environment variable to avoid data loss. Example paths are provided for each platform:
|
||||||
|
|
||||||
|
- **macOS/Linux**:
|
||||||
|
```bash
|
||||||
|
DATA_DIR=~/.open-webui uvx --python 3.11 open-webui serve
|
||||||
|
```
|
||||||
|
|
||||||
|
- **Windows**:
|
||||||
|
```powershell
|
||||||
|
$env:DATA_DIR="C:\open-webui\data"; uvx --python 3.11 open-webui serve
|
||||||
|
```
|
||||||
|
|
||||||
### Installation with `pip`
|
### Installation with `pip`
|
||||||
|
|
||||||
For users installing Open WebUI with Python's package manager `pip`, **it is strongly recommended to use Python runtime managers like `uv` or `conda`**. These tools help manage Python environments effectively and avoid conflicts.
|
For users installing Open WebUI with Python's package manager `pip`, **it is strongly recommended to use Python runtime managers like `uv` or `conda`**. These tools help manage Python environments effectively and avoid conflicts.
|
||||||
|
Loading…
Reference in New Issue
Block a user