Docker Desktop for Mac release notes

Estimated reading time: 11 minutes

Update to the Docker Desktop terms

Professional use of Docker Desktop in large organizations (more than 250 employees or more than $10 million in annual revenue) requires users to have a paid Docker subscription. While the effective date of these terms is August 31, 2021, there is a grace period until January 31, 2022 for those that require a paid subscription. For more information, see Docker Desktop License Agreement.

This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop releases.

Take a look at the Docker Public Roadmap to see what’s coming next.

Docker Desktop 4.4.2

2022-01-13

Download Docker Desktop

Mac with Intel chip Mac with Apple chip

Security

  • Fixed CVE-2021-45449 that affects users currently on Docker Desktop version 4.3.0 or 4.3.1.

Docker Desktop version 4.3.0 and 4.3.1 has a bug that may log sensitive information (access token or password) on the user’s machine during login. This only affects users if they are on Docker Desktop 4.3.0, 4.3.1 and the user has logged in while on 4.3.0, 4.3.1. Gaining access to this data would require having access to the user’s local files.

New

  • Easy, Secure sign in with Auth0 and Single Sign-on
    • Single Sign-on: Users with a Docker Business subscription can now configure SSO to authenticate using their identity providers (IdPs) to access Docker. For more information, see Single Sign-on.
    • Signing in to Docker Desktop now takes you through the browser so that you get all the benefits of auto-filling from password managers.

Upgrades

Bug fixes and minor changes

  • Docker Desktop displays an error if registry.json contains more than one organization in the allowedOrgs field. If you are using multiple organizations for different groups of developers, you must provision a separate registry.json file for each group.
  • Fixed the memory statistics for containers in the Dashboard. Fixes docker/for-mac/#4774.
  • Added a deprecated option to settings.json: "deprecatedCgroupsv1": true, which switches the Linux environment back to cgroups v1. This option will be removed in future releases. If your software requires cgroups v1, you must update it to be compatible with cgroups v2.
  • Fixed a regression in Compose that reverted the container name separator from - to _. Fixes docker/compose-switch.
  • Fixed an issue where putting the machine to Sleep mode after pausing Docker Desktop results in Docker Desktop not being able to resume from pause after the machine comes out of Sleep mode. Fixes for-mac#6058.

Known issues

  • The tips of the week show on top of the mandatory login dialog when an organization restriction is enabled via a registry.json file.

Docker Desktop 4.3.2

2021-12-21

Download Docker Desktop

Mac with Intel chip | Mac with Apple chip

Security

  • Fixed CVE-2021-45449 that affects users currently on Docker Desktop version 4.3.0 or 4.3.1.

Docker Desktop version 4.3.0 and 4.3.1 has a bug that may log sensitive information (access token or password) on the user’s machine during login. This only affects users if they are on Docker Desktop 4.3.0, 4.3.1 and the user has logged in while on 4.3.0, 4.3.1. Gaining access to this data would require having access to the user’s local files.

Upgrades

docker scan v0.14.0

Security

Log4j 2 CVE-2021-44228: We have updated the docker scan CLI plugin. This new version of docker scan is able to detect Log4j 2 CVE-2021-44228 and Log4j 2 CVE-2021-45046.

For more information, read the blog post Apache Log4j 2 CVE-2021-44228.

Docker Desktop 4.3.1

2021-12-11

Download Docker Desktop

Mac with Intel chip | Mac with Apple chip

Upgrades

docker scan v0.11.0

Security

Log4j 2 CVE-2021-44228: We have updated the docker scan CLI plugin for you. Older versions of docker scan in Docker Desktop 4.3.0 and earlier versions are not able to detect Log4j 2 CVE-2021-44228.

For more information, read the blog post Apache Log4j 2 CVE-2021-44228.

Docker Desktop 4.3.0

2021-12-02

Download Docker Desktop

Mac with Intel chip | Mac with Apple chip

Upgrades

Bug fixes and minor changes

  • Docker Desktop on Apple silicon no longer requires Rosetta 2, with the exception of three optional command line tools.
  • Fixed an issue which prevented users from saving files from a volume using the Save As option in the Volumes UI. Fixes docker/for-win#12407.
  • Fixed an issue that sometimes launched the existing version of Docker Desktop even after updating to a newer version.
  • Added a self-diagnose warning if the host lacks Internet connectivity.
  • Docker Desktop now uses cgroupv2. If you need to run systemd in a container then:

Known issue

Docker Dashboard incorrectly displays the container memory usage as zero. You can use the docker stats command on the command line as a workaround to view the actual memory usage. See docker/for-mac#6076.

Deprecation

  • The following internal DNS names are deprecated and will be removed from a future release: docker-for-desktop, docker-desktop, docker.for.mac.host.internal, docker.for.mac.localhost, docker.for.mac.gateway.internal. You must now use host.docker.internal, vm.docker.internal, and gateway.docker.internal.
  • Custom RBAC rules have been removed from Docker Desktop as it gives cluster-admin privileges to all Service Accounts. Fixes docker/for-mac/#4774.

Docker Desktop 4.2.0

2021-11-09

Download Docker Desktop

Mac with Intel chip | Mac with Apple chip

New

Pause/Resume: You can now pause your Docker Desktop session when you are not actively using it and save CPU resources on your machine. For more information, see Pause/Resume.

Software Updates: The option to turn off automatic check for updates is now available for users on all Docker subscriptions, including Docker Personal and Docker Pro. All update-related settings have been moved to the Software Updates section. For more information, see Software updates.

Window management: The Docker Dashboard window size and position persists when you close and reopen Docker Desktop.

Upgrades

Bug fixes and minor changes

  • Improved: Self-diagnose now also checks for overlap between host IPs and docker networks.
  • Fixed the position of the indicator that displays the availability of an update on the Docker Dashboard.
  • Fixed an issue that caused Docker Desktop to stop responding upon clicking Exit on the fatal error dialog.
  • Fixed a rare startup failure affecting users having a docker volume bind-mounted on top of a directory from the host. If existing, this fix will also remove manually user added DENY DELETE ACL entries on the corresponding host directory.
  • Fixed a bug where a Docker.qcow2 file would be ignored on upgrade and a fresh Docker.raw used instead, resulting in containers and images disappearing. Note that if a system has both files (due to the previous bug) then the most recently modified file will be used, to avoid recent containers and images disappearing again. To force the use of the old Docker.qcow2, delete the newer Docker.raw file. Fixes docker/for-mac#5998.
  • Fixed a bug where subprocesses could fail unexpectedly during shutdown, triggering an unexpected fatal error popup. Fixes docker/for-mac#5834.

Docker Desktop 4.1.1

2021-10-12

Download Docker Desktop

Mac with Intel chip | Mac with Apple chip

Bug fixes and minor changes

When upgrading from 4.1.0, the Docker menu does not change to Update and restart so you can just wait for the download to complete (icon changes) and then select Restart. This bug is fixed in 4.1.1, for future upgrades.

  • Fixed a bug where a Docker.qcow2 file would be ignored on upgrade and a fresh Docker.raw used instead, resulting in containers and images disappearing. If a system has both files (due to the previous bug), then the most recently modified file will be used to avoid recent containers and images disappearing again. To force the use of the old Docker.qcow2, delete the newer Docker.raw file. Fixes docker/for-mac#5998.
  • Fixed the update notification overlay sometimes getting out of sync between the Settings button and the Software update button in the Docker Dashboard.
  • Fixed the menu entry to install a newly downloaded Docker Desktop update. When an update is ready to install, the Restart option changes to Update and restart.

Docker Desktop 4.1.0

2021-09-30

Download Docker Desktop

Mac with Intel chip | Mac with Apple chip

New

  • Software Updates: The Settings tab now includes a new section to help you manage Docker Desktop updates. The Software Updates section notifies you whenever there’s a new update and allows you to download the update or view information on what’s included in the newer version. For more information, see Software Updates.
  • Compose V2 You can now specify whether to use Docker Compose V2 in the General settings.
  • Volume Management: Volume management is now available for users on any subscription, including Docker Personal. For more information, see Explore volumes. Ships Docker Public Roadmap#215

Upgrades

Docker Desktop 4.0.1

2021-09-13

Download Docker Desktop

Mac with Intel chip | Mac with Apple chip

Upgrades

  • Compose V2 RC3
    • Compose v2 is now hosted on github.com/docker/compose.
    • Fixed go panic on downscale using compose up --scale.
    • Fixed a race condition in compose run --rm while capturing exit code.

Bug fixes and minor changes

  • Fixed a bug where copy-paste was not available in the Docker Dashboard.

Docker Desktop 4.0.0

2021-08-31

Download Docker Desktop

Mac with Intel chip | Mac with Apple chip

New

Docker has announced updates and extensions to the product subscriptions to increase productivity, collaboration, and added security for our developers and businesses.

The updated Docker Subscription Service Agreement includes a change to the terms for Docker Desktop.

  • Docker Desktop remains free for small businesses (fewer than 250 employees AND less than $10 million in annual revenue), personal use, education, and non-commercial open source projects.
  • It requires a paid subscription (Pro, Team, or Business), for as little as $5 a month, for professional use in larger enterprises.
  • The effective date of these terms is August 31, 2021. There is a grace period until January 31, 2022 for those that will require a paid subscription to use Docker Desktop.
  • The Docker Pro and Docker Team subscriptions now include commercial use of Docker Desktop.
  • The existing Docker Free subscription has been renamed Docker Personal.
  • No changes to Docker Engine or any other upstream open source Docker or Moby project.

To understand how these changes affect you, read the FAQs. For more information, see Docker subscription overview.

Upgrades

Bug fixes and minor changes

  • Fixed a bug where SSH was not available for builds from git URL. Fixes for-mac#5902
Docker Desktop for Mac, release notes