From 5e30c6763cf66d508bfa16ad0fe6ea62ccbb06cb Mon Sep 17 00:00:00 2001
From: silentoplayz <jacwoo21@outlook.com>
Date: Tue, 4 Nov 2025 14:17:05 -0500
Subject: [PATCH] feat(docs): add WSL-specific documentation for Docker

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.
---
 docs/getting-started/quick-start/index.mdx    |  6 +++
 .../quick-start/tab-docker/WSL.md             | 46 +++++++++++++++++++
 2 files changed, 52 insertions(+)
 create mode 100644 docs/getting-started/quick-start/tab-docker/WSL.md

diff --git a/docs/getting-started/quick-start/index.mdx b/docs/getting-started/quick-start/index.mdx
index a68baca..a5c2623 100644
--- a/docs/getting-started/quick-start/index.mdx
+++ b/docs/getting-started/quick-start/index.mdx
@@ -12,6 +12,7 @@ import Podman from './tab-docker/Podman.md';
 import PodmanKubePlay from './tab-docker/PodmanKubePlay.md';
 import ManualDocker from './tab-docker/ManualDocker.md';
 import DockerSwarm from './tab-docker/DockerSwarm.md';
+import WSL from './tab-docker/WSL.md';
 import DockerUpdating from './tab-docker/DockerUpdating.md';
 import Helm from './tab-kubernetes/Helm.md';
 import Venv from './tab-python/Venv.md';
@@ -71,6 +72,11 @@ Choose your preferred installation method below:
           <DockerSwarm />
         </div>
       </TabItem>
+      <TabItem value="wsl" label="WSL">
+        <div className='mt-5'>
+          <WSL />
+        </div>
+      </TabItem>
     </Tabs>
 
   </TabItem>
diff --git a/docs/getting-started/quick-start/tab-docker/WSL.md b/docs/getting-started/quick-start/tab-docker/WSL.md
new file mode 100644
index 0000000..49e93e8
--- /dev/null
+++ b/docs/getting-started/quick-start/tab-docker/WSL.md
@@ -0,0 +1,46 @@
+## 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:
+
+[Install WSL](https://learn.microsoft.com/en-us/windows/wsl/install)
+
+### 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.
+
+1.  **Download Docker Desktop:**
+    [https://www.docker.com/products/docker-desktop/](https://www.docker.com/products/docker-desktop/)
+
+2.  **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
+
+1.  **Open Docker Desktop:**
+    Start the Docker Desktop application.
+
+2.  **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.
+
+```bash
+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 `docker` commands 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.