From fe4c5f0a9faab2d2c5d0d6dcf0685bff1caef676 Mon Sep 17 00:00:00 2001 From: PtJade Ceramic <185668489+PtJade-Ceramic@users.noreply.github.com> Date: Fri, 17 Jul 2026 03:40:52 +0800 Subject: [PATCH 1/3] Revise Docker Desktop installation instructions Updated installation instructions for Docker Desktop on Windows, including interactive, command line, and package manager methods. --- .../desktop/setup/install/windows-install.md | 40 +++++++++++++++++-- 1 file changed, 37 insertions(+), 3 deletions(-) diff --git a/content/manuals/desktop/setup/install/windows-install.md b/content/manuals/desktop/setup/install/windows-install.md index 7ef8d012e847..14629176fda0 100644 --- a/content/manuals/desktop/setup/install/windows-install.md +++ b/content/manuals/desktop/setup/install/windows-install.md @@ -140,7 +140,9 @@ For more information, see [Running Docker Desktop in a VM or VDI environment](/m ## Install Docker Desktop on Windows -### Install interactively +### Install with our installer + +#### Install interactively 1. Download the installer using the download button at the top of the page, or from the [release notes](/manuals/desktop/release-notes.md). @@ -148,7 +150,7 @@ For more information, see [Running Docker Desktop in a VM or VDI environment](/m > [!NOTE] > - >If you want to switch installation mode at a later date, you need to uninstall and reinstall Docker Desktop. + > If you want to switch installation mode at a later date, you need to uninstall and reinstall Docker Desktop. 3. When prompted, ensure the **Use WSL 2 instead of Hyper-V** option on the Configuration page is selected or not depending on your choice of backend. @@ -160,7 +162,7 @@ For more information, see [Running Docker Desktop in a VM or VDI environment](/m 6. [Start Docker Desktop](#start-docker-desktop). -### Install from the command line +#### Install from the command line After downloading `Docker Desktop Installer.exe`, run the following command in a terminal to install Docker Desktop to `%LOCALAPPDATA%\Programs\DockerDesktop`. @@ -214,6 +216,38 @@ See the [Installer flags](#installer-flags) section to see what flags the `insta > >If you want to switch installation mode at a later date, you need to uninstall and reinstall Docker Desktop. +### Install from a package manager + +#### Install from Microsoft Store + +Go to [Microsoft Store Docker Desktop page](https://apps.microsoft.com/detail/XP8CBJ40XLBWKX) and click the Get or Install button on the page. + +> [!IMPORTANT] +> +> ARM64 architecture is not supported. +> +> To check your PC's architecture, enter either `systeminfo` or `start ms-settings:about`, in either Command Prompt or PowerShell, and look up text like `ARM64-based` in the `System Type` (the key name would be localized depending on your preferred Windows display language setting) value. + +#### Install from Window Package Manager + +Run the following command in Command Prompt: + +```sh +winget.exe add --id Docker.DockerDesktop -e -s winget -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity + +rem ARM64 is not supported from Microsoft Store +winget.exe add --id XP8CBJ40XLBWKX -e -s winget -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity +``` + +The following command is specifically available in PowerShell: + +```powershell +Start-Process winget.exe -Args 'add --id Docker.DockerDesktop -e -s winget -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity' -nnw -Wait + +# ARM64 is not supported from Microsoft Store +Start-Process winget.exe -Args 'add --id XP8CBJ40XLBWKX -e -s winget -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity' -nnw -Wait +``` + ## Start Docker Desktop Docker Desktop does not start automatically after installation. To start Docker Desktop: From be79644f5a47302394430ec3a64dde67b53ae2f4 Mon Sep 17 00:00:00 2001 From: PtJade Ceramic <185668489+PtJade-Ceramic@users.noreply.github.com> Date: Fri, 17 Jul 2026 04:07:09 +0800 Subject: [PATCH 2/3] Fix typos in Windows installation instructions --- .../manuals/desktop/setup/install/windows-install.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/content/manuals/desktop/setup/install/windows-install.md b/content/manuals/desktop/setup/install/windows-install.md index 14629176fda0..a52950c4cbe6 100644 --- a/content/manuals/desktop/setup/install/windows-install.md +++ b/content/manuals/desktop/setup/install/windows-install.md @@ -140,7 +140,7 @@ For more information, see [Running Docker Desktop in a VM or VDI environment](/m ## Install Docker Desktop on Windows -### Install with our installer +### Install with the installer #### Install interactively @@ -228,24 +228,24 @@ Go to [Microsoft Store Docker Desktop page](https://apps.microsoft.com/detail/XP > > To check your PC's architecture, enter either `systeminfo` or `start ms-settings:about`, in either Command Prompt or PowerShell, and look up text like `ARM64-based` in the `System Type` (the key name would be localized depending on your preferred Windows display language setting) value. -#### Install from Window Package Manager +#### Install from Windows Package Manager Run the following command in Command Prompt: ```sh -winget.exe add --id Docker.DockerDesktop -e -s winget -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity +winget.exe install --id Docker.DockerDesktop -e -s winget -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity rem ARM64 is not supported from Microsoft Store -winget.exe add --id XP8CBJ40XLBWKX -e -s winget -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity +winget.exe install --id XP8CBJ40XLBWKX -e -s msstore -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity ``` The following command is specifically available in PowerShell: ```powershell -Start-Process winget.exe -Args 'add --id Docker.DockerDesktop -e -s winget -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity' -nnw -Wait +Start-Process winget.exe -ArgumentList 'add --id Docker.DockerDesktop -e -s winget -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity' -nnw -Wait # ARM64 is not supported from Microsoft Store -Start-Process winget.exe -Args 'add --id XP8CBJ40XLBWKX -e -s winget -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity' -nnw -Wait +Start-Process winget.exe -ArgumentList 'add --id XP8CBJ40XLBWKX -e -s msstore -h --accept-package-agreements --authentication-mode silent --accept-source-agreements --disable-interactivity' -nnw -Wait ``` ## Start Docker Desktop From d29e13deee681f47d62281ed57d78d09cee95501 Mon Sep 17 00:00:00 2001 From: PtJade Ceramic <185668489+PtJade-Ceramic@users.noreply.github.com> Date: Fri, 17 Jul 2026 04:10:12 +0800 Subject: [PATCH 3/3] Update instructions for Microsoft Store installation --- content/manuals/desktop/setup/install/windows-install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/manuals/desktop/setup/install/windows-install.md b/content/manuals/desktop/setup/install/windows-install.md index a52950c4cbe6..b761d063daec 100644 --- a/content/manuals/desktop/setup/install/windows-install.md +++ b/content/manuals/desktop/setup/install/windows-install.md @@ -220,7 +220,7 @@ See the [Installer flags](#installer-flags) section to see what flags the `insta #### Install from Microsoft Store -Go to [Microsoft Store Docker Desktop page](https://apps.microsoft.com/detail/XP8CBJ40XLBWKX) and click the Get or Install button on the page. +Go to [Microsoft Store Docker Desktop page](https://apps.microsoft.com/detail/XP8CBJ40XLBWKX) and select the **Get** or **Install** button on the page. > [!IMPORTANT] >