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.
aevesdocker
left a comment
aevesdocker
left a comment
There was a problem hiding this comment.
Thank you @chaomonica
4 participants
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!