content/manuals/desktop/previous-versions/edge-releases-windows.md
This page contains information about Docker Desktop Edge releases. Edge releases give you early access to our newest features. Note that some of the features may be experimental, and some of them may not ever reach the Stable release.
For Docker Desktop system requirements, see What to know before you install.
2020-12-07
2020-11-30
2020-11-26
-v /var/run/docker.sock:. See docker/for-mac#5025.2020-11-18
This release contains a Kubernetes upgrade. Note that your local Kubernetes cluster will be reset after installing Docker Desktop.
2020-10-19
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-10-01
2020-09-17
WSL 2
Other fixes
/host_mnt paths in docker container inspect and docker volume inspect. Fixes docker/for-mac#4859.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-09-09
2020-09-01
2020-08-25
2020-08-20
The Images view on the Dashboard now allows you to interact with images on Docker Hub. You can now pull a remote repository with specific tags from Docker Hub, or view the details of the repository on the Docker Hub page. To access the new Images view, from the Docker menu, select Dashboard > Images.
Docker Desktop now enables BuildKit by default after a reset to factory defaults. To revert to the old docker build experience, go to Preferences > Docker Engine and then disable the BuildKit feature.
Docker Desktop now supports running on WSL 2 on the latest updates of Windows 10 versions 1903 and 1909 (in addition to the existing support for version 2004). This also means that Docker Desktop can be installed on those builds of Windows 10 Home.
dockerd crashes.2020-07-28
Docker Desktop introduces the new Images view to the Docker Dashboard. The Images view allows users to view a list of Docker images on the disk, run an image as a container, pull the latest version of an image from Docker Hub, inspect images, and remove any unwanted images from the disk.
To access the new Images view, from the Docker menu, select Dashboard > Images.
2020-07-21
2020-07-10
2020-07-09
2020-06-29
2020-06-25
hosts is specified inside the Docker daemon.json. See docker/for-win#6895.localhost:2375 is used by another program. See docker/for-win#6929 and docker/for-win#6961.////c/Users/foo, rather than only paths like C:\Users\foo and C:/Users/foo.Function not implemented error during file I/O on shared volumes. See docker/for-win#5955.docker-for-desktop. The context docker-desktop should be used instead. See docker/for-win#5089.2020-05-20
Hyper-V
fallocate for shared filesystems. See docker/for-win#6658.WSL 2
wslpath for path translation, retry mounts on errors at startup.Dashboard
open with vs code button for compose app deployed from a WSL 2 Linux Workspace.Other fixes
-v ~/dir:/vm-dir)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.WSL 2
/mnt/c, /tmp, /run...) don't work correctly when multiple containers mount them.2020-04-28
.. characters. Fixes docker/for-win#5375.ftruncate which prevented libgit2sharp from cloning repositories on shared volumes. See docker/for-win#5808.2020-04-20
Docker Desktop Edge 2.3.0.0 fixes 10 issues reported on the docker/for-win GitHub repository.
WSL 2
Filesharing
File not found errors. Fixes docker/for-win#6200.Other fixes
vpnkit-bridge. Fixed docker/for-win#58412020-04-02
Docker Desktop Edge 2.2.3.0 fixes 28 issues reported on the docker/for-win GitHub repository.
WSL 2
File sharing
Operation not permitted error. Fixes docker/for-win#6016 and docker/for-win#6017.docker volume create -o type=none -o o=bind -o device=C:\Some\Windows\path.fsnotify.WRITE events in Linux containers when files are changed on the host. docker/for-win#5530readlink on shared volumes using "mfsymlinks". Fixes docker/for-win#5793volumes_from in docker-compose.yml. Fixes docker/for-win#5530.Other fixes
Server service. Fixes docker/for-win#5150.:: and ::1) within a container do not currently work. Some web servers and other programs may be using these addresses in their configuration files.2020-03-02
This release contains a Kubernetes upgrade. Note that your local Kubernetes cluster will be reset after installing Docker Desktop.
LanmanServer service. Fixes docker/for-win#5150.host.docker.internal. We also recommend using ports to communicate from the host to a container. For more information, see Networking.2020-02-12
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.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.
2019-12-11
[!NOTE]
Docker Desktop Edge 2.1.7.0 is the release candidate for the upcoming major Stable release. Please help us test this version before the wider release and report any issues in the docker/for-win GitHub repository.
2019-11-20
Unable to stop Hyper-V VM: Cannot validate argument on parameter 'SwitchName'. The argument is null or empty.Windows Insider Preview Slow Ring users running OS builds older than 19025 cannot run WSL 2 following upgrade to Docker Desktop Edge 2.1.6.1. WSL 2 requires Windows 10 Insider Preview build 19018 or greater.
2019-11-18
Added the ability to start and stop Compose-based applications and view combined logs in the Docker Desktop Dashboard UI.
docker run -p 80 -p 443 nginx). Fixes docker/for-win#4935 and docker/compose#6998.Mknod on a shared volume for Windows file sharing.Windows Insider Preview Slow Ring users running OS builds older than 19025 cannot run WSL 2 following upgrade to Docker Desktop Edge 2.1.6.0. WSL 2 requires Windows 10 Insider Preview build 19018 or greater.
2019-11-04
This release contains a Kubernetes upgrade. Note that your local Kubernetes cluster will be reset after installation.
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.
To access the Dashboard UI, select the Docker menu from the system tray and then click Dashboard.
WSL 2 backend: The new Docker Desktop WSL 2 backend replaces the Docker Desktop WSL 2 Tech Preview. The 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 which uses gRPC, FUSE, and Hypervisor sockets instead of Samba, CIFS, and Hyper-V networking. The new implementation offers improved I/O performance. Additionally, when using the new file system:
To switch back to the Samba file system:
From the Docker menu, select Settings > Command line, and then clear the Enable experimental features check box. Alternatively, install a Docker Desktop Stable release.
When you start a Docker Compose application and then start a Docker App which has the same name as the Compose application, Docker Desktop displays only one application on the Dashboard. However, when you expand the application, containers that belong to both applications are displayed on the Dashboard.
When you deploy a Docker App with multiple containers on Kubernetes, Docker Desktop displays each Pod as an application on the Dashboard.
2019-10-15
2019-09-16
2019-09-09
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.2019-08-12
AuthorizationManager check failed errors on machines with strict group policies on PowerShell script signing. docker/for-win#43762019-07-30
This release contains Kubernetes security improvements. Note that your local Kubernetes PKI and cluster will be reset after installation.
docker run -v .kube:kube ... kubectl works.cluster-admin role on local Kubernetes cluster to kube-system namespace.swap is not created every time a virtual machine boots.This is the Edge channel, which gives you early access to our newest features. Be aware that some of them may be experimental, and some of them may not ever reach the Stable release.
This release contains a Kubernetes upgrade. Note that your local Kubernetes cluster will be reset after installation.
Upgrades
New
buildx plugin (currently experimental).Experimental features checkbox on the Docker Desktop settings Daemon page enables experimental features in the Docker daemon and the Docker CLI.Bug fixes and minor changes
Send usage statistics checkbox is selected by default in Docker Desktop for Windows (Community). This option cannot be modified.Known issues
Upgrades
New
App: Docker CLI plugin to configure, share, and install applications
Buildx (Tech Preview): Docker CLI plugin for extended build capabilities with BuildKit
bakeBug fixes and minor changes
Delete of persistent volume claimsUpgrades
Bug fixes and minor changes
Upgrades
New
Bug fixes and minor changes
Upgrades
WARNING: If you have an existing Kubernetes cluster created with Docker Desktop, this upgrade will reset the cluster. If you need to back up your Kubernetes cluster or persistent volumes you can use Ark.
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
Upgrades
New
Deprecation
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
host.docker.internal is not resolved in some cases. Fixes docker/for-win#2402Upgrades
New
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
Upgrades
New
Bug fixes and minor changes
host.docker.internal can be used for host resolution from Windows containers. Fixes docker/for-win#1976Upgrades
Bug fixes and minor changes
Upgrades
New
Bug fixes and minor changes
HOME environment variable already defined (typically started from the command line). Fixes docker/for-win#1880Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
Upgrades
New
Bug fixes and minor changes
host.docker.internal should be used for host resolution from containers. Older aliases (still valid) are deprecated in favor of this one. (See https://tools.ietf.org/html/draft-west-let-localhost-be-localhost-06).Pending.Upgrades
New
Bug fixes and minor changes
Upgrades
New
--platform=linux in Windows container mode to run Linux Containers On Windows. Note that LCOW is still experimental, and requires daemon experimental option.Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
-v //c/..., now mounted in /host_mnt/c in the LinuxKit VM. Fixes docker/for-win#1509, docker/for-win#1516, docker/for-win#1497Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
CoreCountrySpecific Edition.Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
Upgrades
New
Bug fixes and minor changes
docker.for.win.localhost not working in proxy settings. Fixes for-win/#1130Upgrades
New
Bug fixes and minor changes
Upgrades
New
Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
Upgrades
New
Skip this version button in update windowBug fixes and minor changes
Upgrades
Bug fixes and minor changes
[!NOTE]
The link above goes to Docker for Mac issues because a Mac user reported this problem, which applied to both Mac and Windows and was fixed on both.
Upgrades
New
~\.docker\daemon.json instead of settings fileC:\ProgramData\Docker\config\daemon.json instead of settings fileslirp/port-max-idle-timeout to allow the timeout to be adjusted or even disabledBug fixes and minor changes
int or bool database keysUpgrades
Upgrades
New
Bug fixes and minor changes
config.json not being released properly (Fixes docker/for-win#867)Upgrades
Bug fixes and minor changes
Upgrades
Upgrades
Upgrades
Upgrades
New
Bug fixes and minor changes
Upgrades
New
docker.for.win.localhostBug fixes and minor changes
Upgrades
Upgrades
Security
Bug fixes and minor changes
Upgrades
New
Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
docker run with data in stdin anymoreUpgrades
Bug fixes and minor changes
New
Upgrades
Bug fixes and minor changes
New
Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor improvements
Upgrades
Bug fixes and minor improvements
ObjectNotFound in Set-VMFirmwareUpgrades
New
Bug fixes and minor improvements
Upgrades
New
Bug fixes and minor changes
DomainNameUpgrades
[!IMPORTANT]
Plugins installed using the experimental "managed plugins" feature in Docker 1.12 must be removed/uninstalled before upgrading.
Upgrades
Bug fixes and minor improvements
[!IMPORTANT]
Plugins installed using the experimental "managed plugins" feature in Docker 1.12 must be removed/uninstalled before upgrading.
Upgrades
New
Upgrades
Bug fixes and minor changes
[!IMPORTANT]
Plugins installed using the experimental "managed plugins" feature in Docker 1.12 must be removed/uninstalled before upgrading.
New
Upgrades
Bug fixes and minor changes
[!IMPORTANT]
Plugins installed using the experimental "managed plugins" feature in Docker 1.12 must be removed/uninstalled before upgrading.
Hotfixes
New
Upgrades
Bug fixes and minor changes
[!IMPORTANT]
Plugins installed using the experimental "managed plugins" feature in Docker 1.12 must be removed/uninstalled before upgrading.
New
Daemon.json can be modifiedUpgrades
Bug fixes and minor changes
New
Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
Upgrades
Hotfixes
Hotfixes
/dev/pty/ptmxWindows Container support relies on the Windows 10 container feature, which is
experimental at this point. Windows 10 Pro (1607, build number 14393)
requires update KB3192366 (soon to be released through Windows Update) to fully
work. Some insider builds may not work.
New
Upgrades
Bug fixes and minor changes
Windows Container support relies on the Windows 10 container feature, which is
experimental at this point. Windows 10 Pro (1607, build number 14393)
requires update KB3192366 (soon to be released through Windows Update) to fully
work. Some insider builds may not work.
New
Upgrades
Bug fixes and minor changes
New
Upgrades
Bug fixes and minor changes
New
Basic support for Windows containers. On Windows 10 build >= 14372, a switch in the systray icon changes which daemon (Linux or Windows) the Docker CLI talks to
To support trusted registry transparently, all trusted CAs (root or intermediate) on the Windows host are automatically copied to Moby
Reset Credentials also unshares the shared drives
Logs are now rotated every day
Upgrades
Bug fixes and minor changes
We no longer send the same DNS settings twice to the daemon
Fixed the lingering net adapters removal on Windows 10 Anniversary Update
Uploading a diagnostic now shows a proper status message in the Settings
New
Bug fixes and minor changes
Known issues
Only UTF-8 passwords are supported for host filesystem sharing
Docker automatically disables lingering net adapters. The only way to remove them is manually using devmgmt.msc.
Upgrades
Bug fixes and minor changes
slirp: reduce the number of sockets used by UDP NAT, reduce the probability that NAT rules time out earlier than expectedKnown issues
Only UTF-8 passwords are supported for host filesystem sharing.
Docker automatically disables lingering net adapters. The only way to remove them is manually using devmgmt.msc.
New
mfsymlinks smb option to support symlinks on bind mounted foldernobrl smb option to support sqlite on bind mounted foldersUpgrades
Bug fixes and minor changes
reset to factory defaultsKnown issues
devmgmt.msc as documented in Troubleshooting.Unreleased. See Beta 23 for changes.
Known issues
devmgmt.msc as documented in Troubleshooting.New
Docker for Windows is now available from two channels: stable and beta. New features and bug fixes go out first in auto-updates to users in the beta channel. Updates to the stable channel are much less frequent and happen in sync with major and minor releases of the Docker Engine. Only features that are well-tested and ready for production are added to the stable channel releases. For downloads of both and more information, see Install Docker Desktop on Windows.
Removed the docker host name. Containers with exported ports are reachable via localhost.
The UI shows whether the user is on beta or stable channel
Upgrades
Bug fixes and minor changes
Known issues
C:\Program Files\Docker\Kitematic folder before you click Open Kitematic... systray link.New
localhost has been removedBug fixes and minor changes
docker.sock permission issuesNew
Upgrades
Bug fixes and minor changes
com.docker.slirp: included the DNS TCP fallback fix, required when UDP responses are truncateddocker build/events/logs/stats... won't leak when interrupted with Ctrl-C[!NOTE]
Docker 1.12.0 RC3 release introduces a backward incompatible change from RC2. You can fix this by recreating or updating your containers.
Hotfix
Ctrl-C during build.New
http/https proxy configuration to the settingsUpgrades
Bug fixes and minor changes
.msi into C:\Program Files\DockerNew
http/https proxy configuration to the settingsUpgrades
Bug fixes and minor changes
docker build with Ctrl-C actually stops the build.msi into C:\Program Files\DockerUpgrades
Bug fixes and minor changes
dotnet restore could hangdocker inspect on an imageUpgrades
Bug fixes and minor changes
New
localhostUpgrades
Bug fixes and minor changes
Import from toolbox option to the General SettingsdockerNew
config.json)Bug fixes and minor changes
Known issues
New
This Beta release includes some significant changes:
vpnkitdatakit for configurationBug fixes and minor changes
docker run10.0.75.0/24 rangeKnown issues
New
Bug fixes and minor changes
Known issues
Hotfixes
New
Upgrades
Bug fixes and minor changes
docker portvsock half closed issueKnown issues
Due to limitation in the Windows NAT implementation, co-existence with other NAT prefixes needs to be carefully managed. See Troubleshooting for more details.
Logs for the windows service are not aggregated with logs from the GUI. This is expected to be fixed in future versions.
New
Upgrades
Bug fixes and minor changes
Known issues
New
Bug fixes and minor changes
Known issues
New
Bug fixes and minor changes
New
Upgrades
Bug fixes and minor changes
Known issues
Settings are now serialized in JSON. This install loses the current settings.
Docker needs to open ports on the firewall. Sometimes, the user sees a firewall alert dialog. The user should allow the ports to be opened.
The application was upgraded to 64 bits. The installation path changed to C:\Program Files\Docker\Docker. Users might need to close any Powershell/Cmd windows that were already open before the update to get the new PATH. In some cases, users may need to log off and on again.
Bug Fixes
Enhancements
Known issues
Migration from Docker Toolbox can fail sometimes. If this happens, the workaround is to restart the application.
Docker needs to open ports on the firewall, which can activate a firewall alert dialog. Users should allow the ports to be opened.
The application was upgraded to 64 bits. The installation path changed to C:\Program Files\Docker\Docker. If users have PowerShell/Cmd windows already open before the update, they might need to close them to catch the new PATH. In some cases, users need to log off and on again.
Bug Fixes
Kill virtual machines that cannot be shut down properly
Improved the diagnostic information sent with bugsnag reports
Settings window shows when the drive is shared or not
C: drive can be bind mounted with //c or /c. Used to be //c/
Don't try to submit empty tokens
Fixed the version shown in the About box
Fixed a race condition on the logs
Fixed a race condition on the settings
Fixed broken links in the documentation
Replaced sha1 with actual version in the assemblies
Don't start the unused agent process
Enhancements
Bug Fixes
[!NOTE]
Docker for Windows skipped from Beta 1 to Beta 5 at this point to synch up the version numbering with Docker for Mac, which went into beta cycles a little earlier.
Enhancements
console to debug consolemachine from notificationBug Fixes
File sharing
Crashes and Analytics
GUI
General
Installer
General
Hypervisor
Security
Filesystem
General
Hypervision
PATHFilesystem
--volumeNetworking