docs: Added section for WSL installation and verification #22825
Conversation
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
github-actions
bot
added
the
area/desktop
|
@chelnak could you also have a look please whenever you can ? Motivation here is, many customers get stuck in WSL install step or complain about non-admin users getting UAC prompts. Hence we thought a this brief section before the install section. |
| 2. Download the `.msi` installer from the latest stable release (under the Assets drop-down). | ||
| 3. Run the downloaded installer and follow the setup instructions. | ||
|
|
||
| ### Adjust installation based on user's administrator access |
There was a problem hiding this comment.
I'm not quite sure about this one.
When in WSL mode, you only activate the Windows Service if you select "Add the *.docker.internal names to the host's /etc/hosts file (Requires password)" from settings.
There was a problem hiding this comment.
Thanks Craig, I'll double check this on a VM.
There was a problem hiding this comment.
I see that UAC prompt appears in the scenario you mentioned and oops, I missed the part on "com.docker.service is required by Windows containers and Hyper-V backend".
I'll run through installation again tomorrow and fix this. Thanks again @chelnak!
There was a problem hiding this comment.
@chaomonica / @chelnak we can word it something like this:
Title can be "Administrator Privileges and Installation Requirements", since this is generic, it can be outside the "WSL: Verification and Setup" section.
Installing Docker Desktop requires administrator privileges. However, once installed, it can be used without administrative access. Some actions, though, still need elevated permissions. For details, see [Understand permission requirements for Windows].
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 UAC elevation.
There was a problem hiding this comment.
@chelnak I've updated the "Administrator Privileges and Installation Requirements" with @karman-docker 's section above and additionally moved this section ahead of the WSL sections to avoid confusion.
Description
Many customer escalations involving Docker Desktop on Windows involve WSL. While we have internal documentation for for troubleshooting/installation, these do not exist on our public facing docs.
Related issues or tickets
SEG-574 (Slack thread linked in ticket for context)
Reviews
Please do not merge until after technical review!