This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop Stable releases.
Docker for Mac Stable release notes Estimated reading time: 30 minutes This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop Stable releases. Fix instability on High Sierra (docker/for-mac#2069, docker/for-mac#2062, docker/for-mac#2052, docker/for-mac#2029, docker/for-mac#2024). I am using Docker CE v18.06.0-ce-mac70 (26399). Is Docker For Mac same as Docker Community Edition (Mac OS High Sierra)?
For information about Edge releases, see the Edge release notes. For Docker Desktop system requirements, seeWhat to know before you install.
2020-05-11
Docker Desktop introduces a new onboarding tutorial upon first startup. The Quick Start tutorial guides users to get started with Docker in a few easy steps. It includes a simple exercise to build an example Docker image, run it as a container, push and save the image to Docker Hub.
vpnkit-bridge
. Fixes docker/for-win#5841.ahci-hd
to virtio-blk
to avoid an AHCI deadlock, see moby/hyperkit#94 and docker/for-mac#1835./var/folders
by default as it stores per-user temporary files and caches.2020-04-02
/usr/local/bin/docker-machine
symlinks which avoids custom installs of Docker Machine being accidentally deleted in future upgrades. Note that if you have installed Docker Machine manually, then the install might have followed the symlink and installed Docker Machine in /Applications/Docker.app
. In this case, you must manually reinstall Docker Machine after installing this version of Docker Desktop. Fixes docker/for-mac#4208.2020-03-13
2020-02-11
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.
fish
shell for Docker Compose. Fixes docker/for-mac#3795.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.processor does not support desired secondary processor-based controls
.overlay
networks.docker run -p 80 -p 443 nginx
. Fixes docker/for-win#4935 and docker/compose#6998.inotify
events on directories anymore as these can cause mount points to disappear inside containers. Fixes docker/for-mac#3976.Incorrect authentication credentials
error. Fixes docker/for-mac#4010.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-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 now enables you to sign into Docker Hub using two-factor authentication. For more information, see Two-factor authentication.
2019-09-16
2019-09-04
Docker Desktop 2.1.0.2 contains a Kubernetes upgrade. Note that 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.
com.docker.osxfs trace
performance profiling command. Users can now run the com.docker.osxfs trace --summary
option for a high-level summary of operations, instead of receiving a trace of all operations.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.
docker run -v .kube:kube .. kubectl
works.cluster-admin
role on local Kubernetes cluster to kube-system
namespace./etc/machine-id
to the virtual machine. Fixes docker/for-mac#3554.docker-desktop.<domain>
every 10s. It now relies on the host’s DNS domain search order rather than trying to replicate it inside the VM./etc/hosts
to help with diagnostics.~/Library/Containers/com.docker.docker/Data/com.docker.driver.amd64-linux
to ~/Library/Containers/com.docker.docker/Data/vms/0`).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).host.docker.internal
).docker push
to an insecure registry. Fixes docker/for-mac#2392raw
format VM disks by default. This improves disk throughput (from 320MiB/sec to 600MiB/sec in dd
on a 2015 MacBook Pro) and disk space handling.Existing disks are kept in qcow format, if you want to switch to raw format you need to “Remove all data” or “Reset to factory defaults”. See https://docs.docker.com/docker-for-mac/faqs/#disk-usagedocker.for.mac.host.internal
should be used instead of docker.for.mac.localhost
(still valid) for host resolution from containers, since since there is an RFC banning the use of subdomains of localhost. See https://tools.ietf.org/html/draft-west-let-localhost-be-localhost-06.Upgrades
Bug fixes and minor changes
DNS Fixes. Fixes docker/for-mac#1763, docker/for-mac#1811, docker/for-mac#1803
Avoid unnecessary VM reboot (when changing proxy exclude, but no proxy set). Fixes docker/for-mac#1809, docker/for-mac#1801
Upgrades
compact
: mirage/ocaml-qcow#94)New
docker.for.mac.localhost
cached
mount flag to improve performance of macOS mounts when strict consistency is not necessaryBug fixes and minor changes
localhost
correctly (see docker/for-mac#1511)config.json
and osxkeychain
credentialsvmnetd
should not crash when user home directory is on an external driveUpgrades
Upgrades
J-stars victory vs+ mugen v2 2019 download. New
Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
daemon.json
should render nicely in the UIdaemon.json
through a link in advanced subpanelUpgrades
New
daemon.json
)Bug fixes and minor changes
DomainName
Upgrades
We did not distribute a 1.12.4 stable release
Upgrades
Bug fixes and minor changes
General
Fixed an issue where the whale animation during setting change was inconsistent
Fixed an issue where some windows stayed hidden behind another app
Fixed an issue where the Docker status would continue to be yellow/animated after the VM had started correctly
Fixed an issue where Docker for Mac was incorrectly reported as updated
Channel is now displayed in About box
Crash reports are sent over Bugsnag rather than HockeyApp
Fixed an issue where some windows did not claim focus correctly
Added UI when switching channel to prevent user losing containers and settings
Check disk capacity before Toolbox import
Import certificates in etc/ssl/certs/ca-certificates.crt
disk: make the “flush” behaviour configurable for database-like workloads. This works around a performance regression in 1.12.1.
Networking
Proxy: Fixed application of system or custom proxy settings over container restart
DNS: reduce the number of UDP sockets consumed on the host
VPNkit: improve the connection-limiting code to avoid running out of sockets on the host
UDP: handle diagrams bigger than 2035, up to the configured macOS kernel limit
UDP: make the forwarding more robust; drop packets and continue rather than stopping
File sharing
osxfs: Fixed the prohibition of chown on read-only or mode 0 files, (fixesdocker/for-mac#117,docker/for-mac#263,docker/for-mac#633)
osxfs: Fixed race causing some reads to run forever
osxfs: Fixed a simultaneous volume mount race which can result in a crash
Moby
New
Upgrades
Bug fixes and minor changes
General
Fixed communications glitch when UI talks to com.docker.vmnetd Fixes docker/for-mac#90
docker-diagnose
: display and record the time the diagnosis was captured
Don’t compute the container folder in com.docker.vmnetd
Fixes docker/for-mac#47
Warn the user if BlueStacks is installed (potential kernel panic)
Automatic update interval changed from 1 hour to 24 hours
Include Zsh completions
UI Fixes
Networking
VPNKit supports search domains
slirp: support up to 8 external DNS servers
slirp: reduce the number of sockets used by UDP NAT, reduce the probability that NAT rules will time out earlier than expected
Entries from /etc/hosts
should now resolve from within containers
Allow ports to be bound on host addresses other than 0.0.0.0
and 127.0.0.1
Fixes issue reported indocker/for-mac#68
Use Mac System Configuration database to detect DNS
File sharing (osxfs)
Fixed thread leak
CasPartCache.package. compositorCache.package. Save cleaner sims 3 mac mods download.
Fixed a malfunction of new directories that have the same name as an old directory that is still open
Rename events now trigger DELETE and/or MODIFY inotify
events(saving with TextEdit works now)
Fixed an issue that caused inotify
failure and crashes
Fixed a directory file descriptor leak
Fixed socket chowns
Moby
Use default sysfs
settings, transparent huge pages disabled
cgroup
mount to support systemd
in containers
Increase Moby fs.file-max
to 524288
Fixed Moby Diagnostics and Update Kernel
HyperKit
dtrace
support and lock fixesThis bug fix release contains osxfs improvements. The fixed issues may havebeen seen as failures with apt-get and npm in containers, missed inotifyevents or unexpected unmounts.
Bug fixes
osxfs: fixed an issue causing access to children of renamed directories to fail (symptoms: npm failures, apt-get failures)
osxfs: fixed an issue causing some ATTRIB and CREATE inotify events to fail delivery and other inotify events to stop
osxfs: fixed an issue causing all inotify events to stop when an ancestor directory of a mounted directory was mounted
osxfs: fixed an issue causing volumes mounted under other mounts to spontaneously unmount
Components
This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop Stable releases.
Docker for Mac Stable release notes Estimated reading time: 30 minutes This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop Stable releases. Fix instability on High Sierra (docker/for-mac#2069, docker/for-mac#2062, docker/for-mac#2052, docker/for-mac#2029, docker/for-mac#2024). I am using Docker CE v18.06.0-ce-mac70 (26399). Is Docker For Mac same as Docker Community Edition (Mac OS High Sierra)?
For information about Edge releases, see the Edge release notes. For Docker Desktop system requirements, seeWhat to know before you install.
2020-05-11
Docker Desktop introduces a new onboarding tutorial upon first startup. The Quick Start tutorial guides users to get started with Docker in a few easy steps. It includes a simple exercise to build an example Docker image, run it as a container, push and save the image to Docker Hub.
vpnkit-bridge
. Fixes docker/for-win#5841.ahci-hd
to virtio-blk
to avoid an AHCI deadlock, see moby/hyperkit#94 and docker/for-mac#1835./var/folders
by default as it stores per-user temporary files and caches.2020-04-02
/usr/local/bin/docker-machine
symlinks which avoids custom installs of Docker Machine being accidentally deleted in future upgrades. Note that if you have installed Docker Machine manually, then the install might have followed the symlink and installed Docker Machine in /Applications/Docker.app
. In this case, you must manually reinstall Docker Machine after installing this version of Docker Desktop. Fixes docker/for-mac#4208.2020-03-13
2020-02-11
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.
fish
shell for Docker Compose. Fixes docker/for-mac#3795.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.processor does not support desired secondary processor-based controls
.overlay
networks.docker run -p 80 -p 443 nginx
. Fixes docker/for-win#4935 and docker/compose#6998.inotify
events on directories anymore as these can cause mount points to disappear inside containers. Fixes docker/for-mac#3976.Incorrect authentication credentials
error. Fixes docker/for-mac#4010.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-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 now enables you to sign into Docker Hub using two-factor authentication. For more information, see Two-factor authentication.
2019-09-16
2019-09-04
Docker Desktop 2.1.0.2 contains a Kubernetes upgrade. Note that 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.
com.docker.osxfs trace
performance profiling command. Users can now run the com.docker.osxfs trace --summary
option for a high-level summary of operations, instead of receiving a trace of all operations.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.
docker run -v .kube:kube .. kubectl
works.cluster-admin
role on local Kubernetes cluster to kube-system
namespace./etc/machine-id
to the virtual machine. Fixes docker/for-mac#3554.docker-desktop.<domain>
every 10s. It now relies on the host’s DNS domain search order rather than trying to replicate it inside the VM./etc/hosts
to help with diagnostics.~/Library/Containers/com.docker.docker/Data/com.docker.driver.amd64-linux
to ~/Library/Containers/com.docker.docker/Data/vms/0`).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).host.docker.internal
).docker push
to an insecure registry. Fixes docker/for-mac#2392raw
format VM disks by default. This improves disk throughput (from 320MiB/sec to 600MiB/sec in dd
on a 2015 MacBook Pro) and disk space handling.Existing disks are kept in qcow format, if you want to switch to raw format you need to “Remove all data” or “Reset to factory defaults”. See https://docs.docker.com/docker-for-mac/faqs/#disk-usagedocker.for.mac.host.internal
should be used instead of docker.for.mac.localhost
(still valid) for host resolution from containers, since since there is an RFC banning the use of subdomains of localhost. See https://tools.ietf.org/html/draft-west-let-localhost-be-localhost-06.Upgrades
Bug fixes and minor changes
DNS Fixes. Fixes docker/for-mac#1763, docker/for-mac#1811, docker/for-mac#1803
Avoid unnecessary VM reboot (when changing proxy exclude, but no proxy set). Fixes docker/for-mac#1809, docker/for-mac#1801
Upgrades
compact
: mirage/ocaml-qcow#94)New
docker.for.mac.localhost
cached
mount flag to improve performance of macOS mounts when strict consistency is not necessaryBug fixes and minor changes
localhost
correctly (see docker/for-mac#1511)config.json
and osxkeychain
credentialsvmnetd
should not crash when user home directory is on an external driveUpgrades
Upgrades
J-stars victory vs+ mugen v2 2019 download. New
Upgrades
Bug fixes and minor changes
Upgrades
Bug fixes and minor changes
daemon.json
should render nicely in the UIdaemon.json
through a link in advanced subpanelUpgrades
New
daemon.json
)Bug fixes and minor changes
DomainName
Upgrades
We did not distribute a 1.12.4 stable release
Upgrades
Bug fixes and minor changes
General
Fixed an issue where the whale animation during setting change was inconsistent
Fixed an issue where some windows stayed hidden behind another app
Fixed an issue where the Docker status would continue to be yellow/animated after the VM had started correctly
Fixed an issue where Docker for Mac was incorrectly reported as updated
Channel is now displayed in About box
Crash reports are sent over Bugsnag rather than HockeyApp
Fixed an issue where some windows did not claim focus correctly
Added UI when switching channel to prevent user losing containers and settings
Check disk capacity before Toolbox import
Import certificates in etc/ssl/certs/ca-certificates.crt
disk: make the “flush” behaviour configurable for database-like workloads. This works around a performance regression in 1.12.1.
Networking
Proxy: Fixed application of system or custom proxy settings over container restart
DNS: reduce the number of UDP sockets consumed on the host
VPNkit: improve the connection-limiting code to avoid running out of sockets on the host
UDP: handle diagrams bigger than 2035, up to the configured macOS kernel limit
UDP: make the forwarding more robust; drop packets and continue rather than stopping
File sharing
osxfs: Fixed the prohibition of chown on read-only or mode 0 files, (fixesdocker/for-mac#117,docker/for-mac#263,docker/for-mac#633)
osxfs: Fixed race causing some reads to run forever
osxfs: Fixed a simultaneous volume mount race which can result in a crash
Moby
New
Upgrades
Bug fixes and minor changes
General
Fixed communications glitch when UI talks to com.docker.vmnetd Fixes docker/for-mac#90
docker-diagnose
: display and record the time the diagnosis was captured
Don’t compute the container folder in com.docker.vmnetd
Fixes docker/for-mac#47
Warn the user if BlueStacks is installed (potential kernel panic)
Automatic update interval changed from 1 hour to 24 hours
Include Zsh completions
UI Fixes
Networking
VPNKit supports search domains
slirp: support up to 8 external DNS servers
slirp: reduce the number of sockets used by UDP NAT, reduce the probability that NAT rules will time out earlier than expected
Entries from /etc/hosts
should now resolve from within containers
Allow ports to be bound on host addresses other than 0.0.0.0
and 127.0.0.1
Fixes issue reported indocker/for-mac#68
Use Mac System Configuration database to detect DNS
File sharing (osxfs)
Fixed thread leak
CasPartCache.package. compositorCache.package. Save cleaner sims 3 mac mods download.
Fixed a malfunction of new directories that have the same name as an old directory that is still open
Rename events now trigger DELETE and/or MODIFY inotify
events(saving with TextEdit works now)
Fixed an issue that caused inotify
failure and crashes
Fixed a directory file descriptor leak
Fixed socket chowns
Moby
Use default sysfs
settings, transparent huge pages disabled
cgroup
mount to support systemd
in containers
Increase Moby fs.file-max
to 524288
Fixed Moby Diagnostics and Update Kernel
HyperKit
dtrace
support and lock fixesThis bug fix release contains osxfs improvements. The fixed issues may havebeen seen as failures with apt-get and npm in containers, missed inotifyevents or unexpected unmounts.
Bug fixes
osxfs: fixed an issue causing access to children of renamed directories to fail (symptoms: npm failures, apt-get failures)
osxfs: fixed an issue causing some ATTRIB and CREATE inotify events to fail delivery and other inotify events to stop
osxfs: fixed an issue causing all inotify events to stop when an ancestor directory of a mounted directory was mounted
osxfs: fixed an issue causing volumes mounted under other mounts to spontaneously unmount
Components