[PR #789] [CLOSED] docs: add WSL-specific documentation for Docker #831

New issue

Closed

opened 2026-10-18 14:14:58 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-18 14:14:58 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/789
Author: @silentoplayz
Created: 11/4/2025
Status: ❌ Closed

Base: main ← Head: add-WSL-docs

📝 Commits (4)

bac9099 feat: document https://github.com/open-webui/open-webui/pull/18572
58d179e Merge pull request #776 from attilaolah/pr-18572
cbd51cb Merge pull request #786 from open-webui/main
b26e067 feat(docs): add WSL-specific documentation for Docker

📊 Changes

4 files changed (+59 additions, -0 deletions)

View changed files

📝 docs/features/auth/sso/index.mdx (+1 -0)
📝 docs/getting-started/env-configuration.mdx (+6 -0)
📝 docs/getting-started/quick-start/index.mdx (+6 -0)
➕ docs/getting-started/quick-start/tab-docker/WSL.md (+46 -0)

📄 Description

Changelog Entry

Description

This pull request adds dedicated documentation for setting up Open WebUI with Docker in a Windows Subsystem for Linux (WSL) environment. This addresses user feedback regarding the difficulty of getting started on WSL and aims to provide a clearer, more straightforward setup process for users with limited experience in this area.

Added

A new documentation file, WSL.md, in docs/getting-started/quick-start/tab-docker/, containing step-by-step instructions for installing and configuring Docker Desktop for WSL integration.
A new "WSL" tab within the "Docker" section of the Quick Start guide to make the WSL-specific instructions easily accessible.

Changed

Updated docs/getting-started/quick-start/index.mdx to import and render the new WSL.md content within the new tab.

Fixed

Addressed a significant point of user frustration by clarifying the setup process on a common development environment (WSL), which was previously not explicitly covered in the documentation.

Additional Information

This change was created in direct response to user feedback highlighting that the documentation was difficult to follow for those with little experience in WSL, leading to a frustrating setup experience.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/docs/pull/789 **Author:** [@silentoplayz](https://github.com/silentoplayz) **Created:** 11/4/2025 **Status:** ❌ Closed **Base:** `main` ← **Head:** `add-WSL-docs` --- ### 📝 Commits (4) - [`bac9099`](https://github.com/open-webui/docs/commit/bac90991182a4f7778f8b2e139181a9e0cdd2814) feat: document https://github.com/open-webui/open-webui/pull/18572 - [`58d179e`](https://github.com/open-webui/docs/commit/58d179e3c40d4617e128024d7c887fb3c2085fbe) Merge pull request #776 from attilaolah/pr-18572 - [`cbd51cb`](https://github.com/open-webui/docs/commit/cbd51cb12ef279d6eae68ba3a311bef46e5fa0f6) Merge pull request #786 from open-webui/main - [`b26e067`](https://github.com/open-webui/docs/commit/b26e067b88a08bda1eacf283f00b6a311f668581) feat(docs): add WSL-specific documentation for Docker ### 📊 Changes **4 files changed** (+59 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `docs/features/auth/sso/index.mdx` (+1 -0) 📝 `docs/getting-started/env-configuration.mdx` (+6 -0) 📝 `docs/getting-started/quick-start/index.mdx` (+6 -0) ➕ `docs/getting-started/quick-start/tab-docker/WSL.md` (+46 -0) </details> ### 📄 Description # Changelog Entry ### Description - This pull request adds dedicated documentation for setting up Open WebUI with Docker in a Windows Subsystem for Linux (WSL) environment. This addresses [user feedback regarding the difficulty of getting started on WSL](https://github.com/open-webui/open-webui/issues/18920) and aims to provide a clearer, more straightforward setup process for users with limited experience in this area. ### Added - A new documentation file, `WSL.md`, in `docs/getting-started/quick-start/tab-docker/`, containing step-by-step instructions for installing and configuring Docker Desktop for WSL integration. - A new "WSL" tab within the "Docker" section of the Quick Start guide to make the WSL-specific instructions easily accessible. ### Changed - Updated `docs/getting-started/quick-start/index.mdx` to import and render the new `WSL.md` content within the new tab. ### Fixed - Addressed a significant point of user frustration by clarifying the setup process on a common development environment (WSL), which was previously not explicitly covered in the documentation. --- ### Additional Information - This change was created in direct response to user feedback highlighting that the documentation was difficult to follow for those with little experience in WSL, leading to a frustrating setup experience. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:14:58 +00:00