docs/docker-for-windows/release-notes.md

546 lines
24 KiB
Markdown

---
description: Change log / release notes per stable release
keywords: Docker for Windows, stable, release notes
redirect_from:
- /winkit/release-notes/
title: Docker for Windows Stable Release notes
---
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](install.md#what-to-know-before-you-install).
Release notes for _stable_ releases are listed below, [_edge_ release
notes](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](install.md#download-docker-for-windows).
## Stable Releases of 2018
### Docker Community Edition 18.03.1-ce-win65 2018-04-30
[Download](https://download.docker.com/win/stable/17513/Docker%20for%20Windows%20Installer.exe)
* Upgrades
- [Docker 18.03.1-ce](https://github.com/docker/docker-ce/releases/tag/v18.03.1-ce)
- [Docker compose 1.21.1](https://github.com/docker/compose/releases/tag/1.21.1)
- [Notary 0.6.1](https://github.com/docker/notary/releases/tag/v0.6.1)
* Bug fixes and minor changes
- Fix startup failure when the HOME environment variable is already defined (typically started from the command line). Fixes [docker/for-win#1880](https://github.com/docker/for-win/issues/1880)
- Fix startup failure due to incompatibility with other programs (like Razer Synapse 3). Fixes [docker/for-win#1723](https://github.com/docker/for-win/issues/1723)
### Docker Community Edition 18.03.1-ce-win64 2018-04-26
[Download](https://download.docker.com/win/stable/17438/Docker%20for%20Windows%20Installer.exe)
* Upgrades
- [Docker 18.03.1-ce](https://github.com/docker/docker-ce/releases/tag/v18.03.1-ce)
- [Docker compose 1.21.0](https://github.com/docker/compose/releases/tag/1.21.0)
- [Notary 0.6.1](https://github.com/docker/notary/releases/tag/v0.6.1)
* Bug fixes and minor changes
- Fix startup failure when the HOME environment variable is already defined (typically started from the command line). Fixes [docker/for-win#1880](https://github.com/docker/for-win/issues/1880)
- Fix startup failure due to incompatibility with other programs (like Razer Synapse 3). Fixes [docker/for-win#1723](https://github.com/docker/for-win/issues/1723)
### Docker Community Edition 18.03.0-ce-win59 2018-03-26
[Download](https://download.docker.com/win/stable/16762/Docker%20for%20Windows%20Installer.exe)
* Upgrades
- [Docker 18.03.0-ce](https://github.com/docker/docker-ce/releases/tag/v18.03.0-ce)
- [Docker Machine 0.14.0](https://github.com/docker/machine/releases/tag/v0.14.0)
- [Docker compose 1.20.1](https://github.com/docker/compose/releases/tag/1.20.1)
- [Notary 0.6.0](https://github.com/docker/notary/releases/tag/v0.6.0)
- Linux Kernel 4.9.87
- AUFS 20180312
* New
- VM disk size can be changed in settings. Fixes [docker/for-win#105](https://github.com/docker/for-win/issues/105)
- VM Swap size can be changed in settings.
- New menu item to restart Docker.
- Support NFS Volume sharing. See [docker/for-win#1700](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-win/issues/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
- Fix port Windows Containers port forwarding on Windows 10 build 16299 post KB4074588. Fixes [docker/for-win#1707](https://github.com/docker/for-win/issues/1707), [docker/for-win#1737](https://github.com/docker/for-win/issues/1737)
- Fix daemon not starting properly when setting TLS-related options.
- DNS name `host.docker.internal` shoud 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).
- Fix for the HTTP/S transparent proxy when using "localhost" names (e.g. `host.docker.internal`). Fixes [docker/for-win#1130](https://github.com/docker/for-win/issues/1130)
- Fix Linuxkit start on Windows RS4 Insider. Fixes [docker/for-win#1458](https://github.com/docker/for-win/issues/1458), [docker/for-win#1514](https://github.com/docker/for-win/issues/1514), [docker/for-win#1640](https://github.com/docker/for-win/issues/1640)
- Fix risk of privilege escalation. (https://www.tenable.com/sc-report-templates/microsoft-windows-unquoted-service-path-vulnerability)
- All users present in the docker-users group are now able to use docker. Fixes [docker/for-win#1732](https://github.com/docker/for-win/issues/1732)
- Migration of Docker Toolbox images is not proposed anymore in Docker For Windows installer (still possible to [migrate Toolbox images manually](https://docs.docker.com/docker-for-windows/docker-toolbox/) ).
- Better cleanup for Windows containers and images on reset/uninstall. Fixes [docker/for-win#1580](https://github.com/docker/for-win/issues/1580), [docker/for-win#1544](https://github.com/docker/for-win/issues/1544), [docker/for-win#191](https://github.com/docker/for-win/issues/191)
- Desktop icon creation is optional in installer, do not recreate Desktop icon on upgrade (effective on next upgrade). Fixes [docker/for-win#246](https://github.com/docker/for-win/issues/246), [docker/for-win#925](https://github.com/docker/for-win/issues/925), [docker/for-win#1551](https://github.com/docker/for-win/issues/1551)
### Docker Community Edition 17.12.0-ce-win47 2018-01-12
[Download](https://download.docker.com/win/stable/15139/Docker%20for%20Windows%20Installer.exe)
* Bug fixes and minor changes
- Fix linuxKit port-forwarder sometimes not being able to start. Fixes [docker/for-win#1506](https://github.com/docker/for-win/issues/1506)
- Fix certificate management when connecting to a private registry. Fixes [docker/for-win#1512](https://github.com/docker/for-win/issues/1512)
- Fix Mount compatibility when mounting drives with `-v //c/...`, now mounted in /host_mnt/c in the LinuxKit VM. Fixes [docker/for-win#1509](https://github.com/docker/for-win/issues/1509), [docker/for-win#1516](https://github.com/docker/for-win/issues/1516), [docker/for-win#1497](https://github.com/docker/for-win/issues/1497)
- Fix icon displaying edge. Fixes [docker/for-win#1508](https://github.com/docker/for-win/issues/1508)
### Docker Community Edition 17.12.0-ce-win46 2018-01-09
[Download](https://download.docker.com/win/stable/15048/Docker%20for%20Windows%20Installer.exe)
* Upgrades
- [Docker 17.12.0-ce](https://github.com/docker/docker-ce/releases/tag/v17.12.0-ce)
- [Docker compose 1.18.0](https://github.com/docker/compose/releases/tag/1.18.0)
- [Docker Machine 0.13.0](https://github.com/docker/machine/releases/tag/v0.13.0)
- Linux Kernel 4.9.60
* 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](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-win/issues/498)
- Links in Update changelog now open the default browser instead of IE. (fixes [docker/for-win#1311](https://github.com/docker/for-win/issues/1311))
## Stable Releases of 2017
### Docker Community Edition 17.09.1-ce-win42 2017-12-11
[Download](https://download.docker.com/win/stable/14687/Docker%20for%20Windows%20Installer.exe)
* Upgrades
- [Docker 17.09.1-ce](https://github.com/docker/docker-ce/releases/tag/v17.09.1-ce)
- [Docker compose 1.17.1](https://github.com/docker/compose/releases/tag/1.17.1)
- [Docker Machine 0.13.0](https://github.com/docker/machine/releases/tag/v0.13.0)
* Bug fixes and minor changes
- Fix bug during Windows fast-startup process. Fixes [for-win/#953](https://github.com/docker/for-win/issues/953)
- Fix uninstaller issue (in some specific cases dockerd process was not killed properly)
- Fix Net Promoter Score Gui bug. Fixes [for-win/#1277](https://github.com/docker/for-win/issues/1277)
- Fix `docker.for.win.localhost` not working in proxy settings. Fixes [for-win/#1130](https://github.com/docker/for-win/issues/1130)
- Increased timeout for VM boot startup to 2 minutes.
### Docker Community Edition 17.09.0-ce-win33 2017-10-06
[Download](https://download.docker.com/win/stable/13620/Docker%20for%20Windows%20Installer.exe)
* 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](https://download.docker.com/win/stable/13529/Docker%20for%20Windows%20Installer.exe)
* Upgrades
- [Docker 17.09.0-ce](https://github.com/docker/docker-ce/releases/tag/v17.09.0-ce)
- [Docker Compose 1.16.1](https://github.com/docker/compose/releases/tag/1.16.1)
- [Docker Machine 0.12.2](https://github.com/docker/machine/releases/tag/v0.12.2)
- [Docker Credential Helpers 0.6.0](https://github.com/docker/docker-credential-helpers/releases/tag/v0.6.0)
- Linux Kernel 4.9.49
- AUFS 20170911
* 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](https://github.com/docker/for-mac/issues/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](https://download.docker.com/win/stable/13194/Docker%20for%20Windows%20Installer.exe)
* Upgrades
- [Docker 17.06.2-ce](https://github.com/docker/docker-ce/releases/tag/v17.06.2-ce)
- [Docker Machine 0.12.2](https://github.com/docker/machine/releases/tag/v0.12.2)
### Docker Community Edition 17.06.1-ce-rc1-win24 2017-08-24
[Download](https://download.docker.com/win/stable/13025/Docker%20for%20Windows%20Installer.exe)
**Upgrades**
- [Docker 17.06.1-ce-rc1](https://github.com/docker/docker-ce/releases/tag/v17.06.1-ce-rc1)
- Linux Kernel 4.9.36
- AUFS 20170703
**Bug fixes and minor**
- Fix locked container id file (Fixes [docker/for-win#818](https://github.com/docker/for-win/issues/818))
- Avoid expanding variables in PATH env variable (Fixes [docker/for-win#859](https://github.com/docker/for-win/issues/859))
### Docker Community Edition 17.06.0-ce-win18 2017-06-28
[Download](https://download.docker.com/win/stable/12627/Docker%20for%20Windows%20Installer.exe)
**Upgrades**
- [Docker 17.06.0-ce](https://github.com/docker/docker-ce/releases/tag/v17.06.0-ce)
- [Docker Credential Helpers 0.5.2](https://github.com/docker/docker-credential-helpers/releases/tag/v0.5.2)
- [Docker Machine 0.12.0](https://github.com/docker/machine/releases/tag/v0.12.0)
- [Docker compose 1.14.0](https://github.com/docker/compose/releases/tag/1.14.0)
- Linux Kernel 4.9.31
**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](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-win/issues/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](https://download.docker.com/win/stable/12058/Docker%20for%20Windows%20Installer.exe)
**Upgrades**
- Security fix for CVE-2017-7308
### Docker Community Edition 17.03.0, 2017-03-02
[Download](https://download.docker.com/win/stable/10743/Docker%20for%20Windows%20Installer.exe)
**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**
- [Docker 17.03.0-ce](https://github.com/docker/docker/releases/tag/v17.03.0-ce)
- [Docker Compose 1.11.2](https://github.com/docker/compose/releases/tag/1.11.2)
- [Docker Machine 0.10.0](https://github.com/docker/machine/releases/tag/v0.10.0)
- Linux kernel 4.9.12
**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](https://download.docker.com/win/stable/1.13.1.10072/InstallDocker.msi)
**Upgrades**
- [Docker 1.13.1](https://github.com/docker/docker/releases/tag/v1.13.1)
- [Docker Compose 1.11.1](https://github.com/docker/compose/releases/tag/1.11.1)
- Linux kernel 4.9.8
**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](https://download.docker.com/win/stable/1.13.0.9795/InstallDocker.msi)
**Upgrades**
- [Docker 1.13.0](https://github.com/docker/docker/releases/tag/v1.13.0)
- [Docker Compose 1.10](https://github.com/docker/compose/releases/tag/1.10.0)
- [Docker Machine 0.9.0](https://github.com/docker/machine/releases/tag/v0.9.0)
- [Notary 0.4.3](https://github.com/docker/notary/releases/tag/v0.4.3)
- Linux kernel 4.9.4
**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](https://download.docker.com/win/stable/1.12.5.9503/InstallDocker.msi)
**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](https://download.docker.com/win/stable/1.12.3.8488/InstallDocker.msi)
**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**
- Increase default ulimit for memlock (fixes [https://github.com/docker/for-mac/issues/801](https://github.com/docker/for-mac/issues/801))
### Docker for Windows 1.12.1, 2016-09-16
[Download](https://download.docker.com/win/stable/1.12.1.7135/InstallDocker.msi)
>**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](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 automatically disables lingering net adapters. The only way to remove them is manually using `devmgmt.msc` as documented in [Remove stale network adapters](troubleshoot.md#4-remove-stale-network-adapters) under [Networking issues](troubleshoot.md#networking-issues) in Troubleshooting.
### Docker for Windows 1.12.0, 2016-07-28
[Download](https://download.docker.com/win/stable/1.12.0.5968/InstallDocker.msi)
* First stable release
**Components**
* Docker 1.12.0
* Docker Machine 0.8.0
* Docker Compose 1.8.0