Skip to content

Conversation

@silentoplayz
Copy link
Collaborator

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.

attilaolah and others added 4 commits October 24, 2025 09:06
feat: document OAUTH_ROLES_SEPARATOR
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.
@pr-validator-bot
Copy link

ℹ️ INFO

Please ensure you're targeting the correct branch:

  • dev branch: For changes related to upcoming Open WebUI releases (new features, new environment variables, anything dependent on unreleased versions)
  • main branch: For content that can go live immediately (fixes, tutorials, documentation not dependent on unreleased features)

Please adjust your PR target branch accordingly if needed.

@Classic298
Copy link
Collaborator

@silentoplayz can this be merged to main?

@silentoplayz silentoplayz changed the base branch from dev to main November 4, 2025 07:55
@Classic298 Classic298 closed this Nov 4, 2025
@Classic298
Copy link
Collaborator

as discussed on dc

@silentoplayz silentoplayz deleted the add-WSL-docs branch November 4, 2025 19:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants