Docker for Windows Stable Release notes

Estimated reading time: 18 minutes

Here are the main improvements and issues per stable release, starting with the current release. The documentation is always updated for each release.

For system requirements, see What to know before you install.

Release notes for stable releases are listed below, edge release notes are also available. (Following the CE release model, ‘beta’ releases are called ‘edge’ releases.) You can learn about both kinds of releases, and download stable and edge product installers at Download Docker for Windows.

Stable Releases of 2018

Docker Community Edition 18.06.1-ce-win73 2018-08-29

Download

  • Upgrades
  • Bug fixes and minor changes
    • Fix bug in VM activity detection, preventing Docker Desktop to start. Fixes docker/for-win#2404
    • Fix bug in detection when Windows service is not running, and propose to restart the service.
    • Fix local DNS failing to resolve inside containers. Fixes docker/for-win#2301, docker/for-win#2304
    • Fix Kubernetes status display after reset to factory default
    • Fix bug where host.docker.internal is not resolved in some cases. Fixes docker/for-win#2402
    • Use a 1MB vhdx blocksize instead of the default 32MB. See docker/for-win#244. Also see Microsoft Best Practices for running Linux on Hyper-V
    • Fix diagnostics in specific cases when Windows service is not started.
    • Changed back samba default file permission to avoid issue with too open rights. Fixes docker/for-win#2170
    • On RS5 insider, Fix wrong detection of missing feature “Containers” requiring to install feature + reboot.

Docker Community Edition 18.06.0-ce-win72 2018-07-26

Download

  • New
    • Renewed signing certificate. The installer may show a Windows Defender popup until the renewed certificate is whitelisted. Click “More info” to view the app is published by “Docker Inc” and run it.
  • Bug fixes and minor changes
    • Fix bug in automatic feature enabling if “Hyper-V” and “Containers” Windows features are not enabled already when starting Docker Desktop.

Docker Community Edition 18.06.0-ce-win70 2018-07-25

Download

  • Upgrades
  • New
    • Kubernetes Support. You can now run a single-node Kubernetes cluster from the “Kubernetes” Pane in Docker for Windows settings and use kubectl commands as well as docker commands. See https://docs.docker.com/docker-for-windows/kubernetes/
  • Bug fixes and minor changes
    • AUFS storage driver is deprecated in Docker Desktop and AUFS support will be removed in the next major release. You can continue with AUFS in Docker Desktop 18.06.x, but you will need to reset disk image (in Settings > Reset menu) before updating to the next major update. You can check documentation to save images and backup volumes
    • Fix bug which would cause VM logs to be written to RAM rather than disk in some cases, and the VM to hang.
    • Fix security issue with named pipe connection to docker service.
    • Fix VPNKit memory leak. Fixes docker/for-win#2087, moby/vpnkit#371
    • Fix restart issue when using Windows fast startup on latest 1709 Windows updates. Fixes docker/for-win#1741, docker/for-win#1741
    • DNS name host.docker.internal can be used for host resolution from Windows Containers. Fixes docker/for-win#1976
    • Fix broken link in diagnostics window.
    • Added log rotation for docker-ce logs inside the virtual machine.
    • Changed smb permission to avoid issue when trying to manipulate files with different users in containers. Fixes docker/for-win#2170

Docker Community Edition 18.03.1-ce-win65 2018-04-30

Download

Docker Community Edition 18.03.1-ce-win64 2018-04-26

Download

Docker Community Edition 18.03.0-ce-win59 2018-03-26

Download

  • Upgrades
  • New
    • VM disk size can be changed in settings. Fixes docker/for-win#105
    • VM Swap size can be changed in settings.
    • New menu item to restart Docker.
    • Support NFS Volume sharing. See docker/for-win#1700
    • Allow to activate Windows Containers during installation (avoid vm disk creation and vm boot when working only on win containers). See docker/for-win#217.
    • Experimental feature: LCOW containers can now be run next to Windows containers (on Windows RS3 build 16299 and later). Use --platform=linux in Windows container mode to run Linux Containers On Windows. Note that LCOW is experimental, it requires daemon experimental option.
  • Bug fixes and minor changes

Docker Community Edition 17.12.0-ce-win47 2018-01-12

Download

Docker Community Edition 17.12.0-ce-win46 2018-01-09

Download

  • Upgrades
  • New
    • VM entirely built with Linuxkit
    • Add localhost port forwarder for Windows (thanks @simonferquel). Use Microsoft localhost port forwarder when it is available (insider build RS4).
  • Bug fixes and minor changes
    • Display various component versions in About box.
    • Fix Vpnkit issue when username has spaces. See docker/for-win#1429
    • Diagnostic improvements to get VM logs before VM shutdown.
    • Fix installer check for not supported Windows CoreCountrySpecific Edition.
    • Fix a class of startup failures where the database fails to start. See docker/for-win#498
    • Links in Update changelog now open the default browser instead of IE. (fixes docker/for-win#1311)

Stable Releases of 2017

Docker Community Edition 17.09.1-ce-win42 2017-12-11

Download

Docker Community Edition 17.09.0-ce-win33 2017-10-06

Download

  • Bug fixes
    • Fix Docker For Windows unable to start in some cases : removed use of libgmp sometimes causing the vpnkit process to die.

Docker Community Edition 17.09.0-ce-win32 2017-10-02

Download

  • Upgrades
  • New
    • Windows Docker daemon is now started as service for better lifecycle management
    • Store Linux daemon configuration in ~.docker\daemon.json instead of settings file
    • Store Windows daemon configuration in C:\ProgramData\Docker\config\daemon.json instead of settings file
    • VPNKit: add support for ping!
    • VPNKit: add slirp/port-max-idle-timeout to allow the timeout to be adjusted or even disabled
    • VPNKit: bridge mode is default everywhere now
    • Add Skip This version button in update window
  • Security fixes
    • VPNKit: security fix to reduce the risk of DNS cache poisoning attack (reported by Hannes Mehnert https://hannes.nqsb.io/)
  • Bug fixes and minor changes
    • Kernel: Enable TASK_XACCT and TASK_IO_ACCOUNTING
    • Rotate logs in the VM more often (docker/for-win#244)
    • Reset to default stops all engines and removes settings including all daemon.json files
    • Better backend service checks (related to https://github.com/docker/for-win/issues/953)
    • Fix auto updates checkbox, no need to restart the application
    • Fix check for updates menu when auto updates was disable
    • VPNKit: do not block startup when ICMP permission is denied. (Fixes docker/for-win#1036, docker/for-win#1035, docker/for-win#1040)
    • VPNKit: change protocol to support error messages reported back from the server
    • VPNKit: fix a bug which causes a socket to leak if the corresponding TCP connection is idle for more than 5 minutes (related to docker/for-mac#1374)
    • VPNKit: improve the logging around the Unix domain socket connections
    • VPNKit: automatically trim whitespace from int or bool database keys
    • Do not anymore move credentials in credential store at startup

Docker Community Edition 17.06.2-ce-win27 2017-09-06

Download

Docker Community Edition 17.06.1-ce-rc1-win24 2017-08-24

Download

Upgrades

Bug fixes and minor

Docker Community Edition 17.06.0-ce-win18 2017-06-28

Download

Upgrades

New

  • Windows Server 2016 support
  • Windows 10586 is marked as deprecated; it is not supported going forward in stable releases
  • Integration with Docker Cloud, with the ability to control remote Swarms from the local command line interface (CLI) and view your repositories
  • Unified login between the Docker CLI and Docker Hub, Docker Cloud.
  • Sharing a drive can be done on demand, the first time a mount is requested
  • Add an experimental DNS name for the host: docker.for.win.localhost
  • Support for client (i.e. “login”) certificates for authenticating registry access (fixes docker/for-win#569)
  • New installer experience

Bug fixes and minor changes

  • Fixed group access check for users logged in with Active Directory (fixes docker/for-win#785)
  • Check environment variables and add some warnings in logs if they can cause docker to fail
  • Many processes that were running in admin mode are now running within the user identity
  • Cloud federation command lines now opens in the user home directory
  • Named pipes are now created with more constrained security descriptors to improve security
  • Security fix : Users must be part of a specific group “docker-users” to run Docker for windows
  • Reset to default / uninstall also reset docker cli settings and logout user from Docker Cloud and registries
  • Detect a bitlocker policy preventing windows containers to work
  • Fixed an issue on filesharing when explicitly disabled on vmswitch interface
  • Fixed VM not starting when machine had very long name
  • Fixed a bug where Windows daemon.json file was not written (fixes docker/for-win#670)
  • Added patches to the kernel to fix VMBus crash
  • Named pipe client connection should not trigger dead locks on docker run with data in stdin anymore
  • Buffered data should be treated correctly when docker client requests are upgraded to raw streams

Docker Community Edition 17.03.1-ce-win12 2017-05-12

Download

Upgrades

  • Security fix for CVE-2017-7308

Docker Community Edition 17.03.0, 2017-03-02

Download

New

  • Renamed to Docker Community Edition
  • Integration with Docker Cloud: control remote Swarms from the local CLI and view your repositories. This feature is going to be rolled out to all users progressively

Upgrades

Bug fixes and minor changes

  • Match Hyper-V Integration Services by ID, not name
  • Don’t consume 100% CPU when the service is stopped
  • Log the diagnostic id when uploading
  • Improved Firewall handling: stop listing the rules since it can take a lot of time
  • Don’t rollback to the previous engine when the desired engine fails to start
  • Don’t use port 4222 inside the Linux VM
  • Fix startup error of ObjectNotFound in Set-VMFirmware
  • Add detailed logs when firewall is configured
  • Add a link to the Experimental Features documentation
  • Fixed the Copyright in About Dialog
  • VPNKit: fix unmarshalling of DNS packets containing pointers to pointers to labels
  • VPNKit: set the Recursion Available bit on DNS responses from the cache
  • VPNKit: Avoid diagnostics to capture too much data
  • VPNKit: fix a source of occasional packet loss (truncation) on the virtual ethernet link
  • Fix negotiation of TimeSync protocol version (via kernel update)

Docker for Windows 1.13.1, 2017-02-09

Download

Upgrades

Bug fixes and minor changes

  • Add link to experimental features
  • New 1.13 cancellable operations should now be properly handled by the Docker for desktop
  • Various typos fixes
  • Fix in Hyper-V VM setup (should fix ObjectNotFound errors)

Docker for Windows 1.13.0, 2017-01-19

Download

Upgrades

New

  • Windows containers
  • Improved UI for Daemon.json editing
  • VHDX file containing images and non-host mounted volumes can be moved (using “advanced” tab in the UI)
  • Support for arm, aarch64, ppc64le architectures using qemu
  • TRIM support for disk (shrinks virtual disk)
  • VM’s time synchronization is forced after the host wakes from sleep mode
  • Docker Experimental mode can be toggled

Bug fixes and minor changes

  • Improved Proxy UI
  • Improvements to Logging and Diagnostics
  • About Box is now Copy/Paste enabled
  • Improvements in drive sharing code
  • Optimized boot process
  • Trend Micro Office Scan made the Api proxy think no drive was shared
  • Show a link to the virtualization documentation
  • Always remove the disk on factory reset
  • VPNKit: Improved diagnostics
  • VPNKit: Forwarded UDP datagrams should have correct source port numbers
  • VPNKit: If one request fails, allow other concurrent requests to succeed. For example this allows IPv4 servers to work even if IPv6 is broken.
  • VPNKit: Fix bug which could cause the connection tracking to underestimate the number of active connections
  • VPNKit: add a local cache of DNS responses

Stable Releases of 2016

Docker for Windows 1.12.5, 2016-12-20

Download

Upgrades

  • Docker 1.12.5
  • Docker Compose 1.9.0

Skipped Docker for Windows 1.12.4

We did not distribute a 1.12.4 stable release

Docker for Windows 1.12.3, 2016-11-09

Download

New

  • Restore the VM’s configuration when it was changed by the user

  • Detect firewall configuration that might block the file sharing

  • Send more GUI usage statistics to help us improve the product

  • The path to HyperV disks is not hardcoded anymore, making the Toolbox import work with non-standard path

  • Verify that ALL HyperV features are enabled

  • Added Moby console to the logs

  • Save the current engine with the other settings

  • Notary version 0.4.2 installed

  • Reworked the File Sharing dialog and underlying mechanism

    • Pre-fill username
    • Faster and more reliable feedback when the user/password is not valid
    • Better support for domain users
    • Error message in Logs when File Sharing failed for other reasons

Upgrades

  • Docker 1.12.3
  • Linux Kernel 4.4.27
  • Docker Machine 0.8.2
  • Docker Compose 1.8.1
  • aufs 20160912

Bug fixes and minor changes

General

  • Added the settings to the diagnostics

  • Make sure we don’t use an older Nlog library from the GAC

  • Fix a password escaping regression

  • Support writing large values to the database, specially for trusted CAs

  • Preserve the Powershell stacktraces

  • Write OS and Application versions at the top of each log file

  • Don’t recreate the VM if only the DNS server is set

  • The uninstaller now kills the service if it failed to stop it properly

  • Improve debug information

Networking

  • VpnKit is now restarted if it dies

  • VpnKit: impose a connection limit to avoid exhausting file descriptors

  • VpnKit: handle UDP datagrams larger than 2035 bytes

  • VpnKit: reduce the number of file descriptors consumed by DNS

File sharing

  • Faster mount/unmount of shared drives

  • Added a timeout to mounting/unmounting a shared drive

Hyper-V

  • Make sure invalid “DockerNat” switches are not used

Moby

Docker for Windows 1.12.1, 2016-09-16

Download

Important Note:

The auto-update function in Beta 21 cannot install this update. To install the latest beta manually if you are still on Beta 21, download the installer here:

https://download.docker.com/win/beta/InstallDocker.msi

This problem is fixed as of Beta 23 for subsequent auto-updates.

New

  • 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

  • Support multiple DNS servers

  • Added mfsymlinks SMB option to support symlinks on bind mounted folder

  • Added nobrl SMB option to support sqlite on bind mounted folders

  • Detect outdated versions of Kitematic

Upgrades

  • Docker 1.12.1
  • Docker machine 0.8.1
  • Linux kernel 4.4.20
  • aufs 20160905

Bug fixes and minor changes

General

  • Uploading a diagnostic now shows a proper status message in the Settings

  • Docker stops asking to import from Toolbox after an upgrade

  • Docker can now import from Toolbox just after HyperV is activated

  • Added more debug information to the diagnostics

  • Sending anonymous statistics shouldn’t hang anymore when Mixpanel is not available

  • Support newlines in release notes

  • Improve error message when Docker daemon is not responding

  • The configuration database is now stored in-memory

  • Preserve the stacktrace of PowerShell errors

  • Display service stacktrace in error windows

Networking

  • Improve name servers discovery
  • VpnKit supports search domains
  • VpnKit is now compiled with OCaml 4.03 rather than 4.02.3

File sharing

  • Set cifs version to 3.02

  • VnpKit: reduce the number of sockets used by UDP NAT, reduce the probability

  • slirp: reduce the number of sockets used by UDP NAT, reduce the probability that NAT rules time out earlier than expected

  • Fixed password handling for host file system sharing

Hyper-V

  • Automatically disable lingering net adapters that prevent Docker from starting or using the network

  • Automatically delete duplicated MobyLinuxVMs on a reset to factory defaults

  • Improved the HyperV detection and activation mechanism

Moby

  • Fixed Moby Diagnostics and Update Kernel

  • Use default sysfs settings, transparent huge pages disabled

  • Cgroup mount to support systemd in containers

Known issues

Docker for Windows 1.12.0, 2016-07-28

Download

  • First stable release

Components

  • Docker 1.12.0
  • Docker Machine 0.8.0
  • Docker Compose 1.8.0
Docker for Windows, stable, release notes