mirror of https://github.com/docker/docs.git
215 lines
11 KiB
Markdown
215 lines
11 KiB
Markdown
---
|
||
description: Get started with Docker for Windows. This guide covers system requirements,
|
||
where to download, and instructions on how to install and update.
|
||
keywords: docker for windows, docker windows, docker desktop for windows, docker on
|
||
windows, install docker windows, install docker on windows, docker windows 10, docker
|
||
run on windows, installing docker for windows
|
||
title: Install Docker Desktop on Windows
|
||
aliases:
|
||
- /desktop/windows/install/
|
||
- /docker-ee-for-windows/install/
|
||
- /docker-for-windows/install-windows-home/
|
||
- /docker-for-windows/install/
|
||
- /ee/docker-ee/windows/docker-ee/
|
||
- /engine/installation/windows/
|
||
- /engine/installation/windows/docker-ee/
|
||
- /install/windows/docker-ee/
|
||
- /install/windows/ee-preview/
|
||
- /installation/windows/
|
||
---
|
||
|
||
This page contains the download URL, information about system requirements, and instructions on how to install Docker Desktop for Windows.
|
||
|
||
{{< button text="Docker Desktop for Windows" url="https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe" >}}
|
||
|
||
_For checksums, see [Release notes](../release-notes.md)_
|
||
|
||
> **Docker Desktop terms**
|
||
>
|
||
> Commercial use of Docker Desktop in larger enterprises (more than 250
|
||
> employees OR more than $10 million USD in annual revenue) requires a paid
|
||
> subscription.
|
||
|
||
## System requirements
|
||
|
||
{{< tabs >}}
|
||
{{< tab name="WSL 2 backend" >}}
|
||
|
||
- WSL version 1.1.3.0 or later.
|
||
- Windows 11 64-bit: Home or Pro version 21H2 or higher, or Enterprise or Education version 21H2 or higher.
|
||
- Windows 10 64-bit:
|
||
- We recommend Home or Pro 22H2 (build 19045) or higher, or Enterprise or Education 22H2 (build 19045) or higher.
|
||
- Minimum required is Home or Pro 21H2 (build 19044) or higher, or Enterprise or Education 21H2 (build 19044) or higher.
|
||
- Turn on the WSL 2 feature on Windows. For detailed instructions, refer to the
|
||
[Microsoft documentation](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
|
||
- The following hardware prerequisites are required to successfully run
|
||
WSL 2 on Windows 10 or Windows 11:
|
||
|
||
- 64-bit processor with [Second Level Address Translation (SLAT)](https://en.wikipedia.org/wiki/Second_Level_Address_Translation)
|
||
- 4GB system RAM
|
||
- Enable hardware virtualization in BIOS. For more information, see
|
||
[Virtualization](../troubleshoot/topics.md#virtualization).
|
||
|
||
> **Important**
|
||
>
|
||
> To run Windows containers, you need Windows 10 or Windows 11 Professional or Enterprise edition.
|
||
> Windows Home or Education editions only allow you to run Linux containers.
|
||
{ .important }
|
||
|
||
> **Note**
|
||
>
|
||
> Docker only supports Docker Desktop on Windows for those versions of Windows that are still within [Microsoft’s servicing timeline](https://support.microsoft.com/en-us/help/13853/windows-lifecycle-fact-sheet).
|
||
|
||
{{< /tab >}}
|
||
{{< tab name="Hyper-V backend and Windows containers" >}}
|
||
|
||
- Windows 11 64-bit: Pro version 21H2 or higher, or Enterprise or Education version 21H2 or higher.
|
||
- Windows 10 64-bit:
|
||
- We recommend Home or Pro 22H2 (build 19045) or higher, or Enterprise or Education 22H2 (build 19045) or higher.
|
||
- Minimum required is Home or Pro 21H2 (build 19044) or higher, or Enterprise or Education 21H2 (build 19044) or higher.
|
||
|
||
For Windows 10 and Windows 11 Home, see the system requirements in the WSL 2 backend tab.
|
||
|
||
- Turn on Hyper-V and Containers Windows features.
|
||
- The following hardware prerequisites are required to successfully run Client
|
||
Hyper-V on Windows 10:
|
||
|
||
- 64 bit processor with [Second Level Address Translation (SLAT)](https://en.wikipedia.org/wiki/Second_Level_Address_Translation)
|
||
- 4GB system RAM
|
||
- Turn on BIOS-level hardware virtualization support in the
|
||
BIOS settings. For more information, see
|
||
[Virtualization](../troubleshoot/topics.md#virtualization).
|
||
|
||
> **Important**
|
||
>
|
||
> To run Windows containers, you need Windows 10 or Windows 11 Professional or Enterprise edition.
|
||
> Windows Home or Education editions only allow you to run Linux containers.
|
||
{ .important }
|
||
|
||
> **Note**
|
||
>
|
||
> Docker only supports Docker Desktop on Windows for those versions of Windows that are still within [Microsoft’s servicing timeline](https://support.microsoft.com/en-us/help/13853/windows-lifecycle-fact-sheet).
|
||
|
||
{{< /tab >}}
|
||
{{< /tabs >}}
|
||
|
||
Containers and images created with Docker Desktop are shared between all
|
||
user accounts on machines where it is installed. This is because all Windows
|
||
accounts use the same VM to build and run containers. Note that it is not possible to share containers and images between user accounts when using the Docker Desktop WSL 2 backend.
|
||
|
||
Running Docker Desktop inside a VMware ESXi or Azure VM is supported for Docker Business customers.
|
||
It requires enabling nested virtualization on the hypervisor first.
|
||
For more information, see [Running Docker Desktop in a VM or VDI environment](../vm-vdi.md).
|
||
|
||
{{< accordion title="About Windows containers" >}}
|
||
|
||
Looking for information on using Windows containers?
|
||
|
||
* [Switch between Windows and Linux containers](../faqs/windowsfaqs.md#how-do-i-switch-between-windows-and-linux-containers)
|
||
describes how you can toggle between Linux and Windows containers in Docker Desktop and points you to the tutorial mentioned below.
|
||
- [Getting Started with Windows Containers](https://learn.microsoft.com/en-us/virtualization/windowscontainers/quick-start/set-up-environment?tabs=dockerce)
|
||
- Docker Container Platform for Windows [articles and blog
|
||
posts](https://www.docker.com/microsoft/) on the Docker website.
|
||
|
||
{{< /accordion >}}
|
||
|
||
## Install Docker Desktop on Windows
|
||
|
||
{{< tabs >}}
|
||
{{< tab name="Install interactively" >}}
|
||
|
||
1. Double-click **Docker Desktop Installer.exe** to run the installer.
|
||
|
||
2. 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.
|
||
|
||
If your system only supports one of the two options, you will not be able to select which backend to use.
|
||
|
||
3. Follow the instructions on the installation wizard to authorize the installer and proceed with the install.
|
||
|
||
4. When the installation is successful, select **Close** to complete the installation process.
|
||
|
||
5. If your admin account is different to your user account, you must add the user to the **docker-users** group. Run **Computer Management** as an **administrator** and navigate to **Local Users and Groups** > **Groups** > **docker-users**. Right-click to add the user to the group.
|
||
Sign out and sign back in for the changes to take effect.
|
||
|
||
{{< /tab >}}
|
||
{{< tab name="Install from the command line" >}}
|
||
|
||
After downloading **Docker Desktop Installer.exe**, run the following command in a terminal to install Docker Desktop:
|
||
|
||
```console
|
||
$ "Docker Desktop Installer.exe" install
|
||
```
|
||
|
||
If you’re using PowerShell you should run it as:
|
||
|
||
```powershell
|
||
Start-Process 'Docker Desktop Installer.exe' -Wait install
|
||
```
|
||
|
||
If using the Windows Command Prompt:
|
||
|
||
```sh
|
||
start /w "" "Docker Desktop Installer.exe" install
|
||
```
|
||
|
||
The `install` command accepts the following flags:
|
||
- `--quiet`: Suppresses information output when running the installer
|
||
- `--accept-license`: Accepts the [Docker Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement) now, rather than requiring it to be accepted when the application is first run
|
||
- `--no-windows-containers`: Disables the Windows containers integration
|
||
- `--allowed-org=<org name>`: Requires the user to sign in and be part of the specified Docker Hub organization when running the application
|
||
- `--backend=<backend name>`: Selects the default backend to use for Docker Desktop, `hyper-v`, `windows` or `wsl-2` (default)
|
||
- `--installation-dir=<path>`: Changes the default installation location (`C:\Program Files\Docker\Docker`)
|
||
- `--admin-settings`: Automatically creates an `admin-settings.json` file which is used by admins to control certain Docker Desktop settings on client machines within their organization. For more information, see [Settings Management](../hardened-desktop/settings-management/index.md).
|
||
- It must be used together with the `--allowed-org=<org name>` flag.
|
||
- For example:
|
||
|
||
```text
|
||
--allowed-org=<org name> --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"
|
||
```
|
||
|
||
- `--proxy-http-mode=<mode>`: Sets the HTTP Proxy mode, `system` (default) or `manual`
|
||
- `--override-proxy-http=<URL>`: Sets the URL of the HTTP proxy that must be used for outgoing HTTP requests, requires `--proxy-http-mode` to be `manual`
|
||
- `--override-proxy-https=<URL>`: Sets the URL of the HTTP proxy that must be used for outgoing HTTPS requests, requires `--proxy-http-mode` to be `manual`
|
||
- `--override-proxy-exclude=<hosts/domains>`: Bypasses proxy settings for the hosts and domains. Uses a comma-separated list.
|
||
- `--hyper-v-default-data-root=<path>`: Specifies the default location for the Hyper-V VM disk.
|
||
- `--windows-containers-default-data-root=<path>`: Specifies the default location for the Windows containers.
|
||
- `--wsl-default-data-root=<path>`: Specifies the default location for the WSL distribution disk.
|
||
- `--always-run-service`: Lets users switch to Windows containers without needing admin rights.
|
||
|
||
If your admin account is different to your user account, you must add the user to the **docker-users** group:
|
||
|
||
```console
|
||
$ net localgroup docker-users <user> /add
|
||
```
|
||
{{< /tab >}}
|
||
{{< /tabs >}}
|
||
|
||
## Start Docker Desktop
|
||
|
||
Docker Desktop does not start automatically after installation. To start Docker Desktop:
|
||
|
||
1. Search for Docker, and select **Docker Desktop** in the search results.
|
||
|
||
|
||
|
||
2. The Docker menu ({{< inline-image src="images/whale-x.svg" alt="whale menu" >}}) displays the Docker Subscription Service Agreement.
|
||
|
||
{{< include "desktop-license-update.md" >}}
|
||
|
||
3. Select **Accept** to continue. Docker Desktop starts after you accept the terms.
|
||
|
||
Note that Docker Desktop won't run if you do not agree to the terms. You can choose to accept the terms at a later date by opening Docker Desktop.
|
||
|
||
For more information, see [Docker Desktop Subscription Service Agreement](https://www.docker.com/legal/docker-subscription-service-agreement/). We recommend that you also read the [FAQs](https://www.docker.com/pricing/faq).
|
||
|
||
|
||
## Where to go next
|
||
|
||
- [Get started with Docker](/get-started/) is a tutorial that teaches you how to deploy a multi-service stack.
|
||
- [Explore Docker Desktop](../use-desktop/index.md) and all its features.
|
||
- [Troubleshooting](../troubleshoot/overview.md) describes common problems, workarounds, and
|
||
how to get support.
|
||
- [FAQs](../faqs/general.md) provide answers to frequently asked questions.
|
||
- [Release notes](../release-notes.md) lists component updates, new features, and improvements associated with Docker Desktop releases.
|
||
- [Back up and restore data](../backup-and-restore.md) provides instructions on backing up and restoring data related to Docker.
|