Docker for Windows release notes

Estimated reading time: 28 minutes

Update to the Docker Desktop terms

Professional use of Docker Desktop in large organizations (more than 250 employees or more than $10 million in revenue) requires users to have a paid Docker subscription. While the effective date of these terms is August 31, 2021, there is a grace period until January 31, 2022 for those that require a paid subscription. For more information, see Docker Desktop License Agreement.

This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop releases.

Docker Desktop 4.0.1

2021-09-13

Download Docker Desktop

For Windows

Upgrades

  • Compose V2 RC3
    • Compose v2 is now hosted on github.com/docker/compose.
    • Fixed go panic on downscale using compose up --scale.
    • Fixed a race condition in compose run --rm while capturing exit code.

Bug fixes and minor changes

  • Fixed a bug where Docker Desktop would not start correctly with the Hyper-V engine. See docker/for-win#11963
  • Fixed a bug where copy-paste was not available in the Docker Dashboard.

Docker Desktop 4.0.0

2021-08-31

Download Docker Desktop

For Windows

New

Docker has announced updates and extensions to the product subscriptions to increase productivity, collaboration, and added security for our developers and businesses.

The updated Docker Subscription Service Agreement includes a change to the terms for Docker Desktop.

  • Docker Desktop remains free for small businesses (fewer than 250 employees AND less than $10 million in annual revenue), personal use, education, and non-commercial open source projects.
  • It requires a paid subscription (Pro, Team, or Business), for as little as $5 a month, for professional use in larger enterprises.
  • The effective date of these terms is August 31, 2021. There is a grace period until January 31, 2022 for those that will require a paid subscription to use Docker Desktop.
  • The Docker Pro and Docker Team subscriptions now include commercial use of Docker Desktop.
  • The existing Docker Free subscription has been renamed Docker Personal.
  • No changes to Docker Engine or any other upstream open source Docker or Moby project.

    To understand how these changes affect you, read the FAQs. For more information, see Docker subscription overview.

Upgrades

Bug fixes and minor changes

  • Fixed a bug where the CLI tools would not be available in WSL 2 distros.
  • Fixed a bug when switching from Linux to Windows containers due to access rights on panic.log. for-win#11899

Docker Desktop 3.6.0

2021-08-11

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

New

  • Dev Environments: You can now create a Dev Environment from your local Git repository. For more information, see Start a Dev Environment from a local folder.
  • Volume Management: You can now sort volumes by the name, the date created, and the size of the volume. You can also search for specific volumes using the Search field. For more information, see Explore volumes.

Upgrades

Bug fixes and minor changes

  • Update kernel configuration to fix a performance regression in Docker Desktop 3.0.0 that caused publishing container ports to take 10 times longer than on older versions. For more information, see linuxkit/linuxkit#3701 and docker/for-mac#5668.
  • Fixed a bug where the DNS server would fail after receiving an unexpectedly large datagram.
  • Fixed spurious traces on iptables updates.
  • Fixed slowness when adding multiple ports forwarding option.
  • Fixed bug where the WSL 2 synchonization code creates dangling symlinks if the WSL 2 home directory if it is the same as the Windows home directory. Fixes docker/for-win#11668.
  • Fixed docker context ls after upgrade from 3.5.x when the Linux WSL 2 home directory is the same as the Windows home directory.
  • Fixed the permissions on %PROGRAMDATA%\Docker to avoid a potential Windows containers compromise. See CVE-2021-37841. Thanks to Alessio Dalla Piazza for discovering the issue and to @kevpar for helpful discussion.
  • Fixed bug where the Linux home directory under WSL 2 was set to the Windows home directory e.g. /mnt/c/Users/....
  • Fixed bug where Desktop would fail to start if it could not parse CLI contexts. Fixes docker/for-win#11601.
  • Fixed an issue related to log display inside a container docker/for-win#11251.
  • Fixed failures of the Windows Background Intelligent Transfer Service preventing Docker Desktop to start. docker/for-win#11273

Docker Desktop 3.5.2

2021-07-08

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

New

Dev Environments Preview: Dev Environments enable you to seamlessly collaborate with your team members without moving between Git branches to get your code onto your team members’ machines. When using Dev Environments, you can share your in-progress work with your team members in just one click, and without having to deal with any merge conflicts. For more information and for instructions on how to use Dev Environments, see Development Environments Preview.

Upgrades

Bug fixes and minor changes

  • Dev Environments: Fixed a blank screen in some create and remove scenarios. Fixes dev-environments#4
  • Dev Environments: Fixed error handling when removing an environment. Fixes dev-environments#8
  • Dev Environments: The Start, Stop, and Share buttons are disabled while an environment is being created or removed.
  • Do not automatically switch CLI contexts on application start or when switching between Windows and Linux containers. Fixes docker/for-mac#5787 and docker/for-win#11530.
  • Fixed spurious traces on iptables updates.
  • Fixed a delay when adding a multiple port forwarding option.

Docker Desktop 3.5.1

2021-06-25

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

New

Dev Environments Preview: Dev Environments enable you to seamlessly collaborate with your team members without moving between Git branches to get your code onto your team members’ machines. When using Dev Environments, you can share your in-progress work with your team members in just one click, and without having to deal with any merge conflicts. For more information and for instructions on how to use Dev Environments, see Development Environments Preview.

Compose V2 beta: Docker Desktop now includes the beta version of Compose V2, which supports the docker compose command as part of the Docker CLI. For more information, see Compose V2 beta. While docker-compose is still supported and maintained, Compose V2 implementation relies directly on the compose-go bindings which are maintained as part of the specification. The compose command in the Docker CLI supports most of the docker-compose commands and flags. It is expected to be a drop-in replacement for docker-compose. There are a few remaining flags that have yet to be implemented, see the docker-compose compatibility list for more information about the flags that are supported in the new compose command. If you run into any problems with Compose V2, you can easily switch back to Compose v1 by either by making changes in Docker Desktop Experimental Settings, or by running the command docker-compose disable-v2. Let us know your feedback on the new ‘compose’ command by creating an issue in the Compose-CLI GitHub repository.

Bug fixes and minor changes

  • Fixed a bug where users could not install Docker Desktop when the path to the temp folder contained dots. Fixes docker/for-win#11514
  • Fixed a link to the policy that provides details on how Docker handles the uploaded diagnostics data. Fixes docker/for-mac#5741

Docker Desktop 3.5.0

2021-06-23

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

New

Dev Environments Preview: Dev Environments enable you to seamlessly collaborate with your team members without moving between Git branches to get your code onto your team members’ machines. When using Dev Environments, you can share your in-progress work with your team members in just one click, and without having to deal with any merge conflicts. For more information and for instructions on how to use Dev Environments, see Development Environments Preview.

Compose V2 beta: Docker Desktop now includes the beta version of Compose V2, which supports the docker compose command as part of the Docker CLI. For more information, see Compose V2 beta. While docker-compose is still supported and maintained, Compose V2 implementation relies directly on the compose-go bindings which are maintained as part of the specification. The compose command in the Docker CLI supports most of the docker-compose commands and flags. It is expected to be a drop-in replacement for docker-compose. There are a few remaining flags that have yet to be implemented, see the docker-compose compatibility list for more information about the flags that are supported in the new compose command. If you run into any problems with Compose V2, you can easily switch back to Compose v1 by either by making changes in Docker Desktop Experimental Settings, or by running the command docker-compose disable-v2. Let us know your feedback on the new ‘compose’ command by creating an issue in the Compose-CLI GitHub repository.

Upgrades

  • Compose V2 beta
    • Fixed a bug where a container cannot be started when a file is bind-mounted into a nested mountpoint. Fixes docker/compose-cli#1795.
    • Added support for container links and external links.
    • Introduced the docker compose logs --since --until option.
    • docker compose config --profiles now lists all defined profiles.
  • From Kubernetes 1.21.1 to Kubernetes 1.21.2

Bug fixes and minor changes

  • Volume Management
    • Users can now remove a file or directory inside a volume using the the Docker Dashboard.
    • The Volumes view in Docker Dashboard displays the last modified time and the size of the contents inside a volume.
    • Users can save the files and directories inside a volume from Docker Dashboard.
  • Fixed an issue that caused credStore timeout errors when running the docker login command. Fixes docker/for-win#11472
  • Docker Desktop now allows the WSL 2 integration agent to start even when /etc/wsl.conf is malformed.
  • Fixed an issue with the Docker Compose app not being stopped or removed when started by multiple configuration files. docker/for-win#11445
  • Fixed a bug where Docker Desktop fails to restart after a power failure because the Hyper-V VM restarted prematurely.
  • The default docker CLI context is now desktop-linux in Linux containers mode and desktop-windows when in Windows containers mode.
  • Show the Docker Desktop Feedback popup only when clicking Docker menu.

Docker Desktop 3.4.0

2021-06-09

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

New

Volume Management: Docker Desktop users can now create and delete volumes using the Docker Dashboard and also see which volumes are being used. For more information, see Explore volumes.

Compose V2 beta: Docker Desktop now includes the beta version of Compose V2, which supports the docker compose command as part of the Docker CLI. For more information, see Compose V2 beta. While docker-compose is still supported and maintained, Compose V2 implementation relies directly on the compose-go bindings which are maintained as part of the specification. The compose command in the Docker CLI supports most of the docker-compose commands and flags. It is expected to be a drop-in replacement for docker-compose. There are a few remaining flags that have yet to be implemented, see the docker-compose compatibility list for more information about the flags that are supported in the new compose command. If you run into any problems with Compose V2, you can easily switch back to Compose v1 by either by making changes in Docker Desktop Experimental Settings, or by running the command docker-compose disable-v2. Let us know your feedback on the new ‘compose’ command by creating an issue in the Compose-CLI GitHub repository.

Skip Docker Desktop updates: All users can now skip an update when they are prompted to install individual Docker Desktop releases. For more information, see Docker Desktop updates.

Deprecation

  • Docker Desktop no longer installs Notary, docker trust should be used for image signing.

Upgrades

Bug fixes and minor changes

  • Fixed error showing stderr log in the UI. Fixes docker/for-win#11251.
  • Automatically reclaim space after deleting containers by deleting volumes and removing build cache.
  • Docker Compose applications with file names other than docker-compose.yml can now be removed from Docker Desktop. Fixes docker/for-win#11046
  • Fixed version number missing in update dialog window.
  • Fixed an issue where the diagnostics were sometimes not uploaded correctly from the Support dialog.
  • Fixed DNS entries for *.docker.internal and Kubernetes cluster reset after the VM IP changes.
  • Fixed a corrupted internal cache which was preventing Docker Desktop from starting. Fixes docker/for-win#8748.
  • Fixed an issue where docker info sometimes took longer to respond. Fixes docker/for-win#10675

Docker Desktop 3.3.3

2021-05-06

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

Upgrades

Bug fixes and minor changes

  • Fixed the diagnostics failing to upload from the Troubleshoot screen.

Docker Desktop 3.3.2

2021-05-03

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

Upgrades

Bug fixes and minor changes

  • Fixed a bug where a metrics-port defined in the engine’s daemon.json blocks application restart.
  • Fixed a leak of ephemeral ports. Fixes docker/for-mac#5611.
  • Enable buildkit garbage collection by default.
  • Fixed a bug which blocked binding to port 123. Fixes docker/for-mac#5589.
  • Removed the “Deploy Docker Stacks to Kubernetes by default” Kubernetes setting. The component was removed in 2.4.0.0 but we forgot to remove the setting. Fixes docker/for-mac#4966.

Docker Desktop 3.3.1

2021-04-15

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

Bug fixes and minor changes

  • Docker Desktop now ensures the permissions of /dev/null and other devices are correctly set to 0666 (rw-rw-rw-) inside --privileged containers. Fixes docker/for-mac#5527.
  • Fixed an issue that caused docker run to fail when using \\wsl.localhost path to a directory. Fixes docker/for-win#10786
  • Fixed an issue that caused Docker Desktop to fail during startup when it is unable to establish a connection with Docker Hub in the backend. Fixes docker/for-win#10896
  • Fixed file permission when creating a file from a delta update. Fixes docker/for-win#10881

Docker Desktop 3.3.0

2021-04-08

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

New

You can now specify when to download and install a Docker Desktop update. When an update becomes available, Docker Desktop displays an icon to indicate the availability of a newer version. You can download the update in the background whenever convenient. When the download is complete, all you need to do is to click Update and restart to install the latest update.

Developers who use Docker Desktop for professional development purposes may at times need to skip a specific update. For this reason, users with a paid Docker subscription can skip notifications for a particular update when a reminder appears.

For developers in IT managed environments, who don’t have administrative access to install updates to Docker Desktop, there is now an option in the Settings menu to opt out of notifications altogether for Docker Desktop updates if your Docker ID is part of a Team subscription.

Upgrades

Bug fixes and minor changes

  • Fixed an issue when viewing compose applications that have been started with an explicit project name. Fixes docker/for-win#10564.
  • Ensure --add-host host.docker.internal:host-gateway causes host.docker.internal resolves to the host IP, rather than the IP of the IP router. See docker/for-linux#264.
  • Fixed port allocation for Windows containers. Fixes docker/for-win#10552.
  • Fixed an issue where running a container with a random port on the host caused Docker Desktop dashboard to incorrectly open a browser with port 0, instead of using the allocated port.
  • Fixed an issue where pulling an image from Docker Hub using the Docker Desktop dashboard was failing silently.
  • Perform a filesystem check when starting the Linux VM.

Docker Desktop 3.2.2

2021-03-15

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

Bug fixes and minor changes

  • Fixed an issue that stopped containers binding to port 53. Fixes docker/for-win#10601.
  • Fixed an issue that 32-bit Intel binaries were emulated on Intel CPUs. Fixes docker/for-win#10594.
  • Fixed an issue related to high CPU consumption and frozen UI when the network connection is lost. Fixes for-win/#10563.

Docker Desktop 3.2.1

2021-03-05

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

Upgrades

Docker Desktop 3.2.0

2021-03-01

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

New

  • The Docker Dashboard opens automatically when you start Docker Desktop.
  • The Docker Dashboard displays a tip once a week.
  • BuildKit is now the default builder for all users, not just for new installations. To turn this setting off, go to Settings > Docker Engine and add the following block to the Docker daemon configuration file:
    "features": {
      "buildkit": false
    }
    

Upgrades

Deprecation

  • Docker Desktop cannot be installed on Windows 1709 (build 16299) anymore.
  • Removed the deprecated DNS name docker.for.win.localhost. Use DNS name host.docker.internal in a container to access services that are running on the host. docker/for-win#10619

Bug fixes and minor changes

  • Fixed an issue on the container detail screen where the buttons would disappear when scrolling the logs. Fixes docker/for-win#10160
  • Fixed an issue when port forwarding multiple ports with an IPv6 container network. Fixes docker/for-mac#5247
  • Fixed a regression where docker load could not use an xz archive anymore. Fixes docker/for-win#10364
  • Fixed an issue that caused the WSL 2 backend shutdown process to interfere with Windows shutdown. Fixes docker/for-win#5825 docker/for-win#6933 docker/for-win#6446
  • Fixed creds store using desktop.exe from WSL 2. Fixes docker/compose-cli#1181
  • Fixed a navigation issue in the Containers / Apps view. Fixes docker/for-win#10160
  • Fixed container instance view with long container/image name. Fixes docker/for-win#10160
  • Fixed an issue when binding ports on specific IPs. Note: It may now take a bit of time before the docker inspect command shows the open ports. Fixes docker/for-win#10008
  • Fixed an issue where an image deleted from the Docker dashboard was still displayed on the Images view.

Docker Desktop 3.1.0

2021-01-14

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

New

  • Add experimental support for GPU workloads with WSL 2 backend (requires Windows Insider developer channel).
  • Docker daemon now runs within a Debian Buster based container (instead of Alpine).

Upgrades

Bug fixes and minor changes

  • Fixed an issue where disabling proxy settings would not work. Fixes docker/for-win#9357.
  • Fixed UI reliability issues when users create or delete a lot of objects in batches.
  • Redesigned the Support UI to improve usability.

Docker Desktop 3.0.4

2021-01-06

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

Upgrades

Bug fixes and minor changes

  • Fixed an issue that could cause Docker Desktop to fail to start after upgrading to 3.0.0. Fixes docker/for-win#9755.

Docker Desktop 3.0.0

2020-12-10

Download Docker Desktop

We’ve updated the Docker Subscription Service Agreement. Please read the announcement and FAQs to learn how companies using Docker Desktop may be affected. By downloading Docker Desktop, you agree to these updated terms, the Docker Data Processing Agreement, and the Data Privacy Policy.

For Windows

New

  • Use of three-digit version number for Docker Desktop releases.
  • Docker Desktop updates are now much smaller as they will be applied using delta patches. For more information, see Automatic updates.
  • First version of docker compose (as an alternative to the existing docker-compose). Supports some basic commands but not the complete functionality of docker-compose yet.

    • Supports the following subcommands: up, down, logs, build, pull, push, ls, ps
    • Supports basic volumes, bind mounts, networks, and environment variables

      Let us know your feedback by creating an issue in the compose-cli GitHub repository.

  • Docker Hub Tool v0.2.0

Upgrades

Bug fixes and minor changes

  • Downgraded the kernel to 4.19.121 to reduce the CPU usage of hyperkit. Fixes docker/for-mac#5044
  • Fixed an unexpected EOF error when trying to start a non-existing container with -v /var/run/docker.sock:. See docker/for-mac#5025.

Known issues

  • Building an image with BuildKit from a git URL fails when using the form github.com/org/repo. To work around this issue, use the form git://github.com/org/repo.
  • Some DNS addresses fail to resolve within containers based on Alpine Linux 3.13.
Docker Desktop for Windows, release notes