Skip to content

Commit be8f355

Browse files
authored
Merge pull request #22825 from chaomonica/SEG-574
docs: Added section for WSL installation and verification
1 parent 8d1e1d3 commit be8f355

File tree

1 file changed

+35
-0
lines changed

1 file changed

+35
-0
lines changed

content/manuals/desktop/setup/install/windows-install.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -158,6 +158,41 @@ again when you switch back.
158158

159159
{{< /accordion >}}
160160

161+
## Administrator privileges and installation requirements
162+
163+
Installing Docker Desktop requires administrator privileges. However, once installed, it can be used without administrative access. Some actions, though, still need elevated permissions. See [Understand permission requirements for Windows](./windows-permission-requirements.md) for more detail.
164+
165+
If your users do not have administrator rights and plan to perform operations that require elevated privileges, be sure to install Docker Desktop using the `--always-run-service` installer flag. This ensures those actions can still be executed without prompting for User Account Control (UAC) elevation. See [Installer Flags](#installer-flags) for more detail.
166+
167+
## WSL: Verification and setup
168+
169+
If you have chosen to use WSL, first verify that your installed version meets system requirements by running the following command in your terminal:
170+
171+
```console
172+
wsl --version
173+
```
174+
175+
If version details do not appear, you are likely using the inbox version of WSL. This version does not support modern capabilities and must be updated.
176+
177+
You can update or install WSL using one of the following methods:
178+
179+
### Option 1: Install or update WSL via the terminal
180+
181+
1. Open PowerShell or Windows Command Prompt in administrator mode.
182+
2. Run either the install or update command. You may be prompted to restart your machine. For more information, refer to [Install WSL](https://learn.microsoft.com/en-us/windows/wsl/install).
183+
```console
184+
wsl --install
185+
186+
wsl --update
187+
```
188+
189+
### Option 2: Install WSL via the MSI package
190+
191+
If Microsoft Store access is blocked due to security policies:
192+
1. Go to the official [WSL GitHub Releases page](https://github.com/microsoft/WSL/releases).
193+
2. Download the `.msi` installer from the latest stable release (under the Assets drop-down).
194+
3. Run the downloaded installer and follow the setup instructions.
195+
161196
## Install Docker Desktop on Windows
162197

163198
> [!TIP]

0 commit comments

Comments
 (0)