5e30c6763c
Adds a new tab to the Docker quick start guide with instructions for setting up Open WebUI in a WSL environment. This should help users who are new to WSL and Docker get up and running more easily.
1.7 KiB
Using Docker with WSL (Windows Subsystem for Linux)
This guide provides instructions for setting up Docker and running Open WebUI in a Windows Subsystem for Linux (WSL) environment.
Step 1: Install WSL
If you haven't already, install WSL by following the official Microsoft documentation:
Step 2: Install Docker Desktop
Docker Desktop is the easiest way to get Docker running in a WSL environment. It handles the integration between Windows and WSL automatically.
-
Download Docker Desktop: https://www.docker.com/products/docker-desktop/
-
Install Docker Desktop: Follow the installation instructions, making sure to select the "WSL 2" backend during the setup process.
Step 3: Configure Docker Desktop for WSL
-
Open Docker Desktop: Start the Docker Desktop application.
-
Enable WSL Integration:
- Go to Settings > Resources > WSL Integration.
- Make sure the "Enable integration with my default WSL distro" checkbox is selected.
- If you are using a non-default WSL distribution, select it from the list.
Step 4: Run Open WebUI
Now you can run Open WebUI by following the standard Docker instructions from within your WSL terminal.
docker pull ghcr.io/open-webui/open-webui:main
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
Important Notes
-
Run Docker Commands in WSL: Always run
dockercommands from your WSL terminal, not from PowerShell or Command Prompt. -
File System Access: When using volume mounts (
-v), make sure the paths are accessible from your WSL distribution.