Docker Desktop for Mac 2.x release notes

Estimated reading time: 28 minutes

This page contains release notes for Docker Desktop for Mac 2.x.

Docker Desktop Community 2.5.0.1

2020-11-10

Upgrades

Bug fixes and minor changes

Fixed an issue that caused Docker Desktop to crash on MacOS 11.0 (Big Sur) when VirtualBox was also installed. See docker/for-mac#4997.

Docker Desktop Community 2.5.0.0

2020-11-02

Docker Desktop 2.5.0.0 contains a Kubernetes upgrade. Your local Kubernetes cluster will be reset after installing this version.

New

Users with a paid Docker subscription plan can now see the vulnerability scan report on the Remote repositories tab in Docker Desktop.
Docker Desktop introduces a support option for users with a paid Docker subscription.

Security

Fixed local privilege escalation vulnerability caused by inadequate certificate checking. See CVE-2021-3162.

Upgrades

Bug fixes and minor changes

Renamed ‘Run Diagnostics’ to ‘Get support’.
Removed BlueStacks warning message. Fixes docker/for-mac#4863.
Made container start faster in cases where shared volumes have lots of files. Fixes docker/for-mac#4957.
File sharing: fixed changing ownership of read-only files. Fixes docker/for-mac#4989, docker/for-mac#4964.
File sharing: generated ATTRIB inotify events as well as MODIFY. Fixes docker/for-mac#4962.
File sharing: returned EOPNOTSUPP from fallocate for unsupported modes. Fixes minio. Fixes docker/for-mac#4964.
File sharing: fixed a possible premature file handle close.
When sharing Linux directories (/var, /bin, etc) with containers, Docker Desktop avoids watching paths in the host file system.
When sharing a file into a container (e.g. docker run -v ~/.gitconfig) Docker Desktop does not watch the parent directory. Fixes docker/for-mac#4981, docker/for-mac#4975.
Fixed an issue related to NFS mounting. Fixes docker/for-mac#4958.
Allow symlinks to point outside of shared volumes. Fixes docker/for-mac#4862.
Diagnostics: avoid hanging when Kubernetes is in a broken state.
Docker Desktop now supports S_ISUID, S_ISGID and S_ISVTX in calls to chmod(2) on shared filesystems. Fixes docker/for-mac#4943.

Docker Desktop Community 2.4.0.0

2020-09-30

Docker Desktop 2.4.0.0 contains a Kubernetes upgrade. Your local Kubernetes cluster will be reset after installing this version.

New

Docker Compose CLI - 0.1.18, enabling use of volumes with Compose and the Cloud through ECS and ACI.
Docker introduces the new Images view in the Docker Dashboard. The images view allows users to view the Hub images, pull them and manage their local images on disk including cleaning up unwanted and unused images. 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.
Amazon ECR Credential Helper
Docker Desktop now uses much less CPU when there are lots of file events on the host and when running Kubernetes, see docker/roadmap#12.
Docker Desktop now uses gRPC-FUSE for file sharing by default. This uses much less CPU than osxfs, especially when there are lots of file events on the host. To switch back to osxfs, go to Preferences > General and disable gRPC-FUSE.

Upgrades

Bug fixes and minor changes

Docker Desktop on macOS 10.13 is now deprecated.
Removed the legacy Kubernetes context docker-for-desktop. The context docker-desktop should be used instead. Fixes docker/for-win#5089 and docker/for-mac#4089.
Adding the application to the dock and clicking on it will launch the container view if Docker is already running.
Added support for emulating Risc-V via Qemu 4.2.0.
Removed file descriptor limit (setrlimit) of 10240. We now rely on the kernel to impose limits via kern.maxfiles and kern.maxfilesperproc.
Fixed a Mac CPU usage bug by removing the serial console from hyperkit, see docker/roadmap#12. To open a shell in the VM use either nc -U ~/Library/Containers/com.docker.docker/Data/debug-shell.sock.
Copy container logs without ansi colors to clipboard. Fixes docker/for-mac#4786.
Fixed automatic start on log in. See [docker/for-mac#4877] and [docker/for-mac#4890].
Fixed bug where the application won’t start if the username is too long.
Fixed a bug where adding directories like /usr to the filesharing list prevents Desktop from starting. Fixes docker/for-mac#4488
Fixed application startup if hosts is specified inside the Docker daemon.json. See docker/for-win#6895
Docker Desktop always flushes filesystem caches synchronously on container start. See docker/for-mac#4943.
Compose-on-Kubernetes is no longer included in the Docker Desktop installer. You can download it separately from the compose-on-kubernetes release page.

Known issues

There is a known issue when using 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. To work around this issue, switch back to osxfs in Settings. See docker/for-mac#4859.
There is a known issue when enabling Kubernetes where the settings UI fails to update the Kubernetes state. To work around this issue, close and re-open the window.
There is a rare known issue when switching users where the images view continues to show the repositories of the previous user. To work around this issue, close and re-open the window.

Docker Desktop Community 2.3.0.5

2020-09-15

New

The new Cloud integration in Docker CLI makes it easy to run containers in the cloud using either Amazon ECS or Microsoft ACI. For more information, see Deploying Docker containers on ECS and Deploying Docker containers on Azure.

Upgrades

Bug fixes and minor changes

Fixed automatic start on log in. See docker/for-mac#4877 and docker/for-mac#4890

Known issues

The 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.

Docker Desktop Community 2.3.0.4

2020-07-27

Upgrades

Bug fixes and minor changes

Fixed a privilege escalation vulnerability in com.docker.vmnetd. See CVE-2020-15360
Fixed an issue with startup when the Kubernetes certificates have expired. See docker/for-mac#4594
Fix an incompatibility between hyperkit and osquery which resulted in excessive hyperkit CPU usage. See docker/for-mac#3499
Dashboard: Fixed containers logs which were sometimes truncated. Fixes docker/for-win#5954

Docker Desktop Community 2.3.0.3

2020-05-27

Upgrades

Linux kernel 4.19.76

Bug fixes and minor changes

Re-added device-mapper to the embedded Linux kernel. Fixes docker/for-mac#4549.
Fixed hyperkit on newer Macs and newer versions of Hypervisor.framework. Fixes docker/for-mac#4562.

Docker Desktop Community 2.3.0.2

2020-05-11

New

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.

Upgrades

Bug fixes and minor changes

Reduced the size of the Docker Desktop installer from 708 MB to 456 MB.
Fixed bug where containers disappeared from the UI when Kubernetes context is invalid. Fixes docker/for-win#6037.
Fixed a file descriptor leak in vpnkit-bridge. Fixes docker/for-win#5841.
Added a link to the Edge channel from the UI.
Made the embedded terminal resizable.
Fixed a bug where diagnostic upload would fail if the username contained spaces.
Fixed a bug where the Docker UI could be started without the engine.
Switched from ahci-hd to virtio-blk to avoid an AHCI deadlock, see moby/hyperkit#94 and docker/for-mac#1835.
Fixed an issue where a container port could not be exposed on a specific host IP. See docker/for-mac#4209.
Removed port probing from dashboard, just unconditionally showing links to ports that should be available. Fixes docker/for-mac#4264.
Docker Desktop now shares /var/folders by default as it stores per-user temporary files and caches.
Ceph support has been removed from Docker Desktop to save disk space.
Fixed a performance regression when using shared volumes in 2.2.0.5. Fixes [docker/for-mac#4423].

Docker Desktop Community 2.2.0.5

2020-04-02

Bug fixes and minor changes

Removed dangling /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.

Docker Desktop Community 2.2.0.4

2020-03-13

Upgrades

Docker 19.03.8

Bug fixes and minor changes

Kubernetes: Persistent volumes created by claims are now stored in the virtual machine. Fixes docker/for-win#5665.
Fixed an issue which caused Docker Desktop Dashboard to attempt connecting to all exposed ports inside a container. Fixes docker/for-mac#4264.

Docker Desktop Community 2.2.0.3

2020-02-11

Upgrades

Docker Desktop Community 2.2.0.0

2020-01-21

Docker Desktop 2.2.0.0 contains a Kubernetes upgrade. Your local Kubernetes cluster will be reset after installing this version.

Upgrades

New

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.
Introduced a new user interface for the Docker Desktop Preferences 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.

Bug fixes and minor changes

Added missing completions for the fish shell for Docker Compose. Fixes docker/for-mac#3795.
Fixed a bug that did not allow users to copy and paste text in the Preferences > Daemon window. Fixes docker/for-mac#3798.
Added support for 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.
Added a loading overlay to the Settings and Troubleshoot windows to prevent editing conflicts.
Deactivated the Reset Kubernetes button when Kubernetes is not activated.
Improved the navigation in Settings and Troubleshoot UI.
Fixed a bug in the UEFI boot menu that sometimes caused Docker Desktop to hang during restart. Fixes docker/for-mac#2655 and docker/for-mac#3921.
Docker Desktop now allows users to access the host’s SSH agent inside containers. Fixes docker/for-mac#410
Docker Machine is no longer included in the Docker Desktop installer. You can download it separately from the Docker Machine releases page.
Fixed an issue that caused VMs running on older hardware with macOS Catalina to fail on startup with the error processor does not support desired secondary processor-based controls.
Fixed port forwarding when containers are using overlay networks.
Fixed a container start error when a container has more than one port with an arbitrary or not-yet-configured external port number. For example, docker run -p 80 -p 443 nginx. Fixes docker/for-win#4935 and docker/compose#6998.
Fixed an issue that occurs when sharing overlapping directories.
Fixed a bug that prevented users from changing the location of the VM disk image.
Docker Desktop does not inject inotify events on directories anymore as these can cause mount points to disappear inside containers. Fixes docker/for-mac#3976.
Fixed an issue that caused Docker Desktop to fail on startup when there is an incomplete Kubernetes config file.
Fixed an issue where attempts to log into Docker through Docker Desktop could sometimes fail with the Incorrect authentication credentials error. Fixes docker/for-mac#4010.

Known issues

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.

Docker Desktop Community 2.1.0.5

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.

Upgrades

Docker Desktop Community 2.1.0.4

2019-10-21

Upgrades

New

Docker Desktop now enables you to sign into Docker Hub using two-factor authentication. For more information, see Two-factor authentication.

Docker Desktop Community 2.1.0.3

2019-09-16

Upgrades

Kitematic 0.17.8

Bug fixes and minor changes

All binaries included in Docker Desktop are now notarized so that they can run on macOS Catalina. For more information, see Notarization Requirement for Mac Software.

Docker Desktop Community 2.1.0.2

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.

Upgrades

Docker Desktop Community 2.1.0.1

2019-08-08

Note that you must sign in and create a Docker ID in order to download Docker Desktop.

Upgrades

New

Selecting the ‘Experimental features’ checkbox in the Daemon Preferences menu turns on experimental features for Docker daemon and Docker CLI.
Improved the reliability of 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.
Docker Desktop now supports large lists of DNS resource records on Mac. Fixes docker/for-mac#2160.

Experimental

Docker Desktop Community 2.1.0.0 contains the following experimental features.

Docker App: Docker App is a CLI plugin that helps configure, share, and install applications. For more information, see Working with Docker App.
Docker Buildx: Docker Buildx is a CLI plugin for extended build capabilities with BuildKit. For more information, see Working with Docker Buildx.

Bug fixes and minor changes

Docker Desktop now allows users to expose privileged UDP ports. docker/for-mac#3775
Fixed an issue where running some Docker commands can fail if you are not using Credential Helpers. docker/for-mac#3785
Changed the host’s kubernetes context so that docker run -v .kube:kube ... kubectl works.
Restricted the cluster-admin role on local Kubernetes cluster to kube-system namespace.
Reduced the VM startup time. swap is not created every time a virtual machine boots.
Fixed Kubernetes installation with VPNkit subnet.
Fixed a bug where the process output was not redirected to stdout when gathering diagnostics on Windows, which sometimes resulted in a crash.
Added /etc/machine-id to the virtual machine. Fixes docker/for-mac#3554.
Docker Desktop does not send DNS queries for 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.
Removed the ability to log in using email address as a username as the Docker command line does not support this.
Docker Desktop now allows running a Docker registry inside a container. Fixes docker/for-mac#3611.
Fixed a stability issue with the DNS resolver.
Docker Desktop truncates UDP DNS responses which are over 512 bytes in sizes.
Fixed port 8080 that was used on localhost when starting Kubernetes. Fixes docker/for-mac#3522.
Improved error messaging: Docker Desktop does not prompt users to run diagnostics, or to reset to factory default when it is not appropriate.
Kubernetes: Docker Desktop now uses the default maximum number of pods for kubelet. docker/for-mac#3453.
Fixed DockerHelper crash. docker/for-mac#3470.
Fixed binding of privileged ports with specified IP. docker/for-mac#3464
Fixed service log collection in diagnostics.
Docker Desktop now gathers /etc/hosts to help with diagnostics.
When two services have a common exposed port, Docker Desktop now exposes the available ports for the second service. docker/for-mac#3438.
Docker Desktop ensures localhost resolves to 127.0.0.1. This is related to docker/for-mac#2990, docker/for-mac#3383.

Docker Community Edition 2.0.0.3 2019-02-15

Upgrades
- Docker 18.09.2, fixes CVE-2019-5736

Docker Community Edition 2.0.0.2 2019-01-16

Upgrades
- Docker 18.09.1
- Docker Machine 0.16.1
- Kubernetes 1.10.11, fixes CVE-2018-1002105
- Kitematic 0.17.6
- Golang 1.10.6, fixes CVEs: CVE-2018-16875, CVE-2018-16873 and CVE-2018-16874
Bug fixes and minor changes
- Add 18.09 missing daemon options

Docker Community Edition 2.0.0.0-mac81 2018-12-07

Upgrades
- Docker compose 1.23.2

Docker Community Edition 2.0.0.0-mac78 2018-11-19

Upgrades
- Docker 18.09.0
- Docker compose 1.23.1
- Docker Machine 0.16.0
- Kitematic 0.17.5
- Linux Kernel 4.9.125
New
- New version scheme
Deprecation
- Removed support of AUFS
- Removed support of OSX 10.11
Bug fixes and minor changes
- Fix appearance in dark mode for OSX 10.14 (Mojave)
- VPNKit: Improved scalability of port forwarding. Related to docker/for-mac#2841
- VPNKit: Limit the size of the UDP NAT table. This ensures port forwarding and regular TCP traffic continue even when running very chatty UDP protocols.
- Ensure Kubernetes can be installed when using a non-default internal IP subnet.
- Fix panic in diagnose

Docker Desktop for Mac 2.x release notes