content/manuals/desktop/previous-versions/2.x-windows.md
This page contains release notes for Docker Desktop for Windows 2.x.
2020-11-10
2020-11-02
Docker Desktop 2.5.0.0 contains a Kubernetes upgrade. Your local Kubernetes cluster will be reset after installing this version.
localhost or 127.0.0.1. Fixes docker/for-win#8750.docker run -v ~/.gitconfig) Docker Desktop does not watch the parent directory. Fixes docker/for-mac#4981.2020-09-30
Docker Desktop 2.4.0.0 contains a Kubernetes upgrade. Your local Kubernetes cluster will be reset after installing this version.
docker build experience, go to Settings > Docker Engine and then disable the BuildKit feature.docker-for-desktop. The context docker-desktop should be used instead. Fixes docker/for-win#5089 and docker/for-mac#4089.putty -serial \\.\pipe\dockerDebugShell.hosts is specified inside the Docker daemon.json. See docker/for-win#6895chronyd to sntpcd to work around host time synchronization problems. Fixes docker/for-win#4526.localhost:2375 is in use by another program. See docker/for-win#6929 docker/for-win#6961.docker run -v /var/run/docker.sock rewrites Windows paths properly, see docker/for-win#6628.localhost and 127.0.0.1 can both be used in the proxy settings to redirect to a proxy on the host. Fixes docker/for-win#5715 and docker/for-win#6260./mnt/wsl would break WSL integration. See docker/for-win#7836.docker run -v \\wsl$\Ubuntu\home\simon\web:/web ...)docker-desktop wsl distribution is stopped and display a clearer error message.docker-compose with named volumes and gRPC FUSE: second and subsequent calls to docker-compose up will fail due to the volume path having the prefix /host_mnt.2020-09-15
clock_gettime64 system call returns EPERM rather than ENOSYS
in i386 images. To work around this issue, disable seccomp by using
the --privileged flag. See docker/for-win#8326.2020-07-27
////c/Users/foo, rather than only paths like C:\Users\foo and C:/Users/foo.2020-05-27
mssql image. Fixes docker/for-win#6646fallocate for shared file systems. See docker/for-win#6658:z attribute in bind mounts to fail. Fixes docker/for-win#6634.2020-05-11
WSL 2
chmod/chown on WSL 2 bind mounts. Fixes docker/for-win#6284.Filesharing
File not found errors. Fixes docker/for-win#6200.Other fixes
vpnkit-bridge. Fixed docker/for-win#5841expose on TCP Docker engine API setting on application restart. Setting will now take effect when the Apply button is clicked.WSL 2
/mnt/c, /tmp, /run...) don't work correctly when multiple containers mount them.2020-04-02
fsnotify.WRITE events in Linux containers when files are changed on the host. Fixes docker/for-win#5530.readlink on shared volumes using "mfsymlinks". Fixes docker/for-win#5793.volumes_from in docker-compose.yml. See docker/for-win#5530.Operation not permitted error. Fixes docker/for-win#6016 and docker/for-win#6017.2020-03-13
MODIFY events on shared file systems for Windows file sharing. Fixes docker/for-win#5530.EEXIST. Fixes docker/for-win#5894.Some CLI commands fail if you are running Docker Desktop in the experimental Linux Containers on Windows (LCOW) mode. As alternatives, we recommend running either traditional Linux containers, or the experimental WSL backend.
It is not possible to resize the disk image using the Docker Desktop Settings UI. If you would like to update the size of the disk image (for example, to 128 GB), run the following command in PowerShell:
Resize-VHD -Path 'C:\ProgramData\DockerDesktop\vm-data\DockerDesktop.vhdx' -SizeBytes 128gb
2020-02-11
docker-compose.yml. Fixes docker/for-win#5516.no_proxy environment variable has an entry that starts with a dot (.). Fixes docker/for-win/5551.DockerCli.exe -SharedDrives failed to display a list of drives that are shared. Fixes docker/for-win#5625.test, you must open it as test. Attempts to open the file as Test will fail with the error No such file or directory. For more information, see Tips on shared drives, permissions, and volume mounts in File sharing.DockerNAT has been removed from Docker Desktop 2.2.0.0 as using an IP address to communicate from the host to a container is not a supported feature. To communicate from a container to the host, you must use the special DNS name host.docker.internal. We also recommend using ports to communicate from the host to a container. For more information, see Networking.
However, if your current setup relies on IP addresses for communication, you can use a temporary workaround to reinstate DockerNAT. To do this, open
C:\Program Files\Docker\Docker\resources\MobyLinux.ps1 and add $SwitchName = "DockerNAT" between line 175 and 176. Note that the temporary workaround to reinstate DockerNAT may be removed from future releases.
Directory junctions in shared volumes pointing outside the shared volume do not work.
It is currently not possible to rename open files within shared volumes.
In some cases, Docker containers do not synchronize time with the host when the host machine is put to sleep.
It is not possible to use localhost in the proxy settings. You can instead use host.docker.internal to work around this issue.
2020-01-21
Docker Desktop 2.2.0.0 contains a Kubernetes upgrade. Your local Kubernetes cluster will be reset after installing this version.
Docker Desktop Dashboard: The new Docker Desktop Dashboard provides a user-friendly interface which enables you to interact with containers and applications, and manage the lifecycle of your applications directly from the UI. In addition, it allows you to access the logs, view container details, and monitor resource utilization to explore the container behavior. For detailed information about the new Dashboard UI, see Docker Desktop Dashboard.
WSL 2 backend: The experimental Docker Desktop WSL 2 backend architecture introduces support for Kubernetes, provides an updated Docker daemon, offers VPN-friendly networking, and additional features. For more information, see Docker Desktop WSL 2 backend.
New file sharing implementation: Docker Desktop introduces a new file sharing implementation that replaces Samba, CIFS, and Hyper-V networking. The new implementation offers improved I/O performance. Additionally, when using the new file system:
Users don't have to expose the Samba port, and therefore do not experience issues related to IT firewall or drive-sharing policy.
There is no need to provide user credentials to Docker Desktop. File access rights are automatically enforced when accessing mounted folders through containers.
For more information, see the blog post New file sharing implementation in Docker Desktop Windows.
Added the WSL Integration option in Settings > Resources to select WSL 2 distributions. This option will be visible only after enabling WSL 2 on your machine.
Introduced a new user interface for the Docker Desktop Settings menu.
The Restart, Reset, and Uninstall options are now available on the Troubleshoot menu.
Added the ability to start and stop existing Compose-based applications and view combined logs in the Docker Desktop Dashboard UI.
Expect: 100-continue headers in the Docker API proxy. Some HTTP clients such as curl send this header when the payload is large, for example, when creating containers. Fixes moby/moby#39693.docker run -p 80 -p 443 nginx). Fixes docker/for-win#4935 and docker/compose#6998.inotify events on shared filesystems.Unable to stop Hyper-V VM: Cannot validate argument on parameter 'SwitchName'. The argument is null or empty.ImDisk Toolkit does not work.2019-11-18
Docker Desktop 2.1.0.5 contains a Kubernetes upgrade. Note that your local Kubernetes cluster will be reset after installing this version.
2019-10-21
Docker Desktop 2.1.0.4 contains a Kubernetes upgrade. Note that your local Kubernetes cluster will be reset after installing this version.
Docker Desktop now enables you to sign into Docker Hub using two-factor authentication.
2019-09-16
2019-09-04
Docker Desktop 2.1.0.2 contains a Kubernetes upgrade. Your local Kubernetes cluster will be reset after installing this version.
2019-08-08
Note that you must sign in and create a Docker ID in order to download Docker Desktop.
Experimental features provide early access to future product functionality. These features are intended for testing and feedback only as they may change between releases without warning or can be removed entirely from a future release. Experimental features must not be used in production environments. Docker does not offer support for experimental features.
Docker Desktop Community 2.1.0.0 contains the following experimental features:
AuthorizationManager check failed errors on machines with strict group policies on PowerShell script signing. docker/for-win#4376value cannot be null. docker/for-win#4343cluster-admin role on local Kubernetes cluster to kube-system namespace./etc/hosts to help with diagnostics.Upgrades
Bug fix
Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
Upgrades
New
Deprecation
Bug fixes and minor changes