--- description: Change log / release notes for Docker Desktop for Windows keywords: Docker Desktop for Windows, release notes title: Docker for Windows release notes toc_min: 1 toc_max: 2 redirect_from: - /docker-for-windows/edge-release-notes/ - /docker-for-windows/release-notes/ - /winkit/release-notes/ --- > **Update to the Docker Desktop terms** > > Professional use of Docker Desktop in large organizations (more than 250 employees or more than $10 million in annual 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](../../../subscription/index.md#docker-desktop-license-agreement). {: .important} This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop releases. Take a look at the [Docker Public Roadmap](https://github.com/docker/roadmap/projects/1){: target="_blank" rel="noopener" class="_"} to see what's coming next. ## Docker Desktop 4.3.1 2021-12-11 > Download Docker Desktop > > [For > Windows](https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-win-amd64){: > .button .primary-btn } ### Upgrades [docker scan v0.11.0](https://github.com/docker/scan-cli-plugin/releases/tag/v0.11.0){: target="_blank" rel="noopener" class="_"} ### Security **Log4j 2 CVE-2021-44228**: We have updated the `docker scan` CLI plugin for you. Older versions of `docker scan` in Docker Desktop 4.3.0 and earlier versions are not able to detect [Log4j 2 CVE-2021-44228](https://nvd.nist.gov/vuln/detail/CVE-2021-44228){: target="_blank" rel="noopener" class="_"}. For more information, read the blog post [Apache Log4j 2 CVE-2021-44228](https://www.docker.com/blog/apache-log4j-2-cve-2021-44228/){: target="_blank" rel="noopener" class="_"}. ## Docker Desktop 4.3.0 2021-12-02 > Download Docker Desktop > > [For Windows](https://desktop.docker.com/win/main/amd64/71786/Docker%20Desktop%20Installer.exe) ### Upgrades - [Docker Engine v20.10.11](https://docs.docker.com/engine/release-notes/#201011) - [containerd v1.4.12](https://github.com/containerd/containerd/releases/tag/v1.4.12) - [Buildx 0.7.1](https://github.com/docker/buildx/releases/tag/v0.7.1) - [Compose v2.2.1](https://github.com/docker/compose/releases/tag/v2.2.1) - [Kubernetes 1.22.4](https://github.com/kubernetes/kubernetes/releases/tag/v1.22.4) - [Docker Hub Tool v0.4.4](https://github.com/docker/hub-tool/releases/tag/v0.4.4) - [Go 1.17.3](https://golang.org/doc/go1.17) ### Bug fixes and minor changes - Fixed an issue which prevented users from saving files from a volume using the Save As option in the Volumes UI. Fixes [docker/for-win#12407](https://github.com/docker/for-win/issues/12407). - Fixed an issue that caused Docker Desktop to fail during startup if the home directory path contains a character used in regular expressions. Fixes [docker/for-win#12374](https://github.com/docker/for-win/issues/12374). - Added a self-diagnose warning if the host lacks Internet connectivity. - Docker Desktop now uses cgroupv2. If you need to run `systemd` in a container then: - Ensure your version of `systemd` supports cgroupv2. [It must be at least `systemd` 247](https://github.com/systemd/systemd/issues/19760#issuecomment-851565075). Consider upgrading any `centos:7` images to `centos:8`. - Containers running `systemd` need the following options: [`--privileged --cgroupns=host -v /sys/fs/cgroup:/sys/fs/cgroup:rw`](https://serverfault.com/questions/1053187/systemd-fails-to-run-in-a-docker-container-when-using-cgroupv2-cgroupns-priva). ### Known issue Docker Dashboard incorrectly displays the container memory usage as zero on Hyper-V based machines. You can use the [`docker stats`](../../../engine/reference/commandline/stats.md) command on the command line as a workaround to view the actual memory usage. See [docker/for-mac#6076](https://github.com/docker/for-mac/issues/6076). ### Deprecation - The following internal DNS names are deprecated and will be removed from a future release: `docker-for-desktop`, `docker-desktop`, `docker.for.mac.host.internal`, `docker.for.mac.localhost`, `docker.for.mac.gateway.internal`. You must now use `host.docker.internal`, `vm.docker.internal`, and `gateway.docker.internal`. - Removed: Custom RBAC rules have been removed from Docker Desktop as it gives `cluster-admin` privileges to all Service Accounts. Fixes [docker/for-mac/#4774](https://github.com/docker/for-mac/issues/4774). ## Docker Desktop 4.2.0 2021-11-09 > Download Docker Desktop > > [For Windows](https://desktop.docker.com/win/main/amd64/70708/Docker%20Desktop%20Installer.exe) ### New **Pause/Resume**: You can now pause your Docker Desktop session when you are not actively using it and save CPU resources on your machine. For more information, see [Pause/Resume](../index.md#pauseresume). - Ships [Docker Public Roadmap#226](https://github.com/docker/roadmap/issues/226){: target="_blank" rel="noopener" class="_"} **Software Updates**: The option to turn off automatic check for updates is now available for users on all Docker subscriptions, including Docker Personal and Docker Pro. All update-related settings have been moved to the **Software Updates** section. For more information, see [Software updates](../index.md#software-updates). - Ships [Docker Public Roadmap#228](https://github.com/docker/roadmap/issues/228){: target="_blank" rel="noopener" class="_"} **Window management**: The Docker Dashboard window size and position persists when you close and reopen Docker Desktop. ### Upgrades - [Docker Engine v20.10.10](https://docs.docker.com/engine/release-notes/#201010) - [containerd v1.4.11](https://github.com/containerd/containerd/releases/tag/v1.4.11) - [runc v1.0.2](https://github.com/opencontainers/runc/releases/tag/v1.0.2) - [Go 1.17.2](https://golang.org/doc/go1.17) - [Compose v2.1.1](https://github.com/docker/compose/releases/tag/v2.1.1) - [docker-scan 0.9.0](https://github.com/docker/scan-cli-plugin/releases/tag/v0.9.0) ### Bug fixes and minor changes - Improved: Self-diagnose now also checks for overlap between host IPs and `docker networks`. - Fixed the position of the indicator that displays the availability of an update on the Docker Dashboard. - Fixed Docker Desktop sometimes hanging when clicking Exit in the fatal error dialog. - Fixed an issue that frequently displayed the **Download update** popup when an update has been downloaded but hasn't been applied yet [docker/for-win#12188](https://github.com/docker/for-win/issues/12188). - Fixed installing a new update killing the application before it has time to shut down. - Fixed: Installation of Docker Desktop now works even with group policies preventing users to start prerequisite services (e.g. LanmanServer) [docker/for-win#12291](https://github.com/docker/for-win/issues/12291). ## Docker Desktop 4.1.1 2021-10-12 > Download Docker Desktop > > [For Windows](https://desktop.docker.com/win/main/amd64/69879/Docker%20Desktop%20Installer.exe) ### Bug fixes and minor changes - Fixed a regression in WSL 2 integrations for some distros (e.g. Arch or Alpine). Fixes [docker/for-win#12229](https://github.com/docker/for-win/issues/12229) - Fixed update notification overlay sometimes getting out of sync between the Settings button and the Software update button in the Dashboard. ## Docker Desktop 4.1.0 2021-09-30 > Download Docker Desktop > > [For Windows](https://desktop.docker.com/win/main/amd64/69386/Docker%20Desktop%20Installer.exe) ### New - **Software Updates**: The Settings tab now includes a new section to help you manage Docker Desktop updates. The **Software Updates** section notifies you whenever there's a new update and allows you to download the update or view information on what's included in the newer version. For more information, see [Software Updates](../index.md#software-updates). - **Compose V2** You can now specify whether to use [Docker Compose V2](../../../compose/cli-command.md) in the General settings. - **Volume Management**: Volume management is now available for users on any subscription, including Docker Personal. For more information, see [Explore volumes](../../dashboard.md#explore-volumes). Ships [Docker Public Roadmap#215](https://github.com/docker/roadmap/issues/215){: target="_blank" rel="noopener" class="_"} ### Upgrades - [Compose V2](https://github.com/docker/compose/releases/tag/v2.0.0) - [Buildx 0.6.3](https://github.com/docker/buildx/releases/tag/v0.6.3) - [Kubernetes 1.21.5](https://github.com/kubernetes/kubernetes/releases/tag/v1.21.5) - [Go 1.17.1](https://github.com/golang/go/releases/tag/go1.17.1) - [Alpine 3.14](https://alpinelinux.org/posts/Alpine-3.14.0-released.html) - [Qemu 6.1.0](https://wiki.qemu.org/ChangeLog/6.1) - Base distro to debian:bullseye ### Bug fixes and minor changes - Fixed a bug related to anti-malware software triggering, self-diagnose avoids calling the `net.exe` utility. - Fixed filesystem corruption in the WSL 2 Linux VM in self-diagnose. This can be caused by [microsoft/WSL#5895](https://github.com/microsoft/WSL/issues/5895). - Fixed `SeSecurityPrivilege` requirement issue. See [docker/for-win#12037](https://github.com/docker/for-win/issues/12037). - Fixed CLI context switch sync with UI. See [docker/for-win#11721](https://github.com/docker/for-win/issues/11721). - Added the key `vpnKitMaxPortIdleTime` to `settings.json` to allow the idle network connection timeout to be disabled or extended. - Fixed a crash on exit. See [docker/for-win#12128](https://github.com/docker/for-win/issues/12128). - Fixed a bug where the CLI tools would not be available in WSL 2 distros. - Fixed switching from Linux to Windows containers that was stuck because access rights on panic.log. See [for-win#11899](https://github.com/docker/for-win/issues/11899). ### Known Issue Docker Desktop may fail to start when upgrading to 4.1.0 on some WSL-based distributions such as ArchWSL. See [docker/for-win#12229](https://github.com/docker/for-win/issues/12229) ## Docker Desktop 4.0.1 2021-09-13 > Download Docker Desktop > > [For Windows](https://desktop.docker.com/win/main/amd64/68347/Docker Desktop Installer.exe) ### Upgrades - [Compose V2 RC3](https://github.com/docker/compose/releases/tag/v2.0.0-rc.3) - 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](https://github.com/docker/for-win/issues/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](https://desktop.docker.com/win/main/amd64/67817/Docker Desktop Installer.exe) ### New Docker has [announced](https://www.docker.com/blog/updating-product-subscriptions/){: target="*blank" rel="noopener" class="*" id="dkr_docs_relnotes_btl"} 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](https://www.docker.com/legal/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](https://www.docker.com/pricing/faq){: target="*blank" rel="noopener" class="*" id="dkr_docs_relnotes_btl"}. For more information, see [Docker subscription overview](../../../subscription/index.md). ### Upgrades - [Compose V2 RC2](https://github.com/docker/compose-cli/releases/tag/v2.0.0-rc.2) - Fixed project name to be case-insensitive for `compose down`. See [docker/compose-cli#2023](https://github.com/docker/compose-cli/issues/2023) - Fixed non-normalized project name. - Fixed port merging on partial reference. - [Kubernetes 1.21.4](https://github.com/kubernetes/kubernetes/releases/tag/v1.21.4) ### 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](https://github.com/docker/for-win/issues/11899)