diff --git a/docs/getting-started/env-configuration.mdx b/docs/getting-started/env-configuration.mdx
index 8d148c97..b0e6d872 100644
--- a/docs/getting-started/env-configuration.mdx
+++ b/docs/getting-started/env-configuration.mdx
@@ -737,9 +737,34 @@ The format for the JSON response is strictly:
- Type: `str` (JSON array)
- Default: `[]`
- Description: Specifies a JSON array of tool server connection configurations. Each connection should define the necessary parameters to connect to external tool servers that implement the OpenAPI/MCPO protocol. The JSON must be properly formatted or it will fallback to an empty array.
-- Example: `'[{"name": "example-server", "url": "https://api.example.com", "api_key": "your-key"}]'`
+- Example:
+```json
+[
+ {
+ "type": "openapi",
+ "url": "example-url",
+ "spec_type": "url",
+ "spec": "",
+ "path": "openapi.json",
+ "auth_type": "none",
+ "key": "",
+ "config": { "enable": true },
+ "info": {
+ "id": "",
+ "name": "example-server",
+ "description": "MCP server description."
+ }
+ }
+]
+```
- Persistence: This environment variable is a `PersistentConfig` variable.
+:::warning
+
+The JSON data structure of `TOOL_SERVER_CONNECTIONS` might evolve over time as new features are added.
+
+:::
+
### Autocomplete
#### `ENABLE_AUTOCOMPLETE_GENERATION`
diff --git a/docs/getting-started/quick-start/index.mdx b/docs/getting-started/quick-start/index.mdx
index a68baca8..a5c26235 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:
+
+
+
+
+
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 00000000..49e93e8b
--- /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.