Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 37 additions & 3 deletions content/manuals/desktop/setup/install/windows-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,15 +140,17 @@ For more information, see [Running Docker Desktop in a VM or VDI environment](/m

## Install Docker Desktop on Windows

### Install interactively
### Install with the 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).

2. Double-click `Docker Desktop Installer.exe` to run the installer. The installer will ask which installation mode you prefer. Choosing per-user installs to `%LOCALAPPDATA%\Programs\DockerDesktop` and requires no administrator privileges. Choosing all users will prompt for elevation.

> [!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.

Expand All @@ -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`.

Expand Down Expand Up @@ -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 select 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 Windows Package Manager

Run the following command in Command Prompt:

```sh
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 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 -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 -ArgumentList 'add --id XP8CBJ40XLBWKX -e -s msstore -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:
Expand Down