Skip to content

Commit fd5458f

Browse files
Merge pull request #22883 from docker/published-update
publish updates from main
2 parents 35abf84 + 804ee1b commit fd5458f

File tree

2 files changed

+37
-3
lines changed

2 files changed

+37
-3
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]

content/manuals/security/for-admins/access-tokens.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,9 @@ linkTitle: Organization access tokens
1010

1111
> [!WARNING]
1212
>
13-
> Organization access tokens (OATs) are not intended to be used with Docker
14-
> Desktop or Docker Scout, and are incompatible.
13+
> Organization access tokens (OATs) are incompatible with Docker Desktop.
1514
>
16-
> If you use Docker Desktop or Docker Scout, you must use personal
15+
> If you use Docker Desktop, you must use personal
1716
> access tokens instead.
1817
1918
An organization access token (OAT) is like a [personal access token

0 commit comments

Comments
 (0)