This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop releases. For frequently asked questions about Docker Desktop releases, see FAQs.
Docker Desktop versions older than 6 months from the latest release are not available for download.
Take a look at the Docker Public Roadmap to see what's coming next.
4.34.2#
{ { < release-date date="2024-09-12" > } }
{ { < desktop-install-v2 all=true beta_win_arm=true version="4.34.2" build_path="/167172/" > } }
Bug fixes and enhancements#
For all platforms#
- Fixed a bug where
docker compose up
would become unresponsive while in Resource Saver mode.
Security#
- Fixed CVE-2024-8695 which allows RCE via crafted extension description/changelog which could be abused by a malicious extension.
- Fixed CVE-2024-8696 which allows RCE via crafted extension publisher-url/additional-urls which could be abused by a malicious extension.
4.34.1#
{ { < release-date date="2024-09-05" > } }
{ { < desktop-install-v2 win=true beta_win_arm=true version="4.34.1" build_path="/166053/" > } }
Bug fixes and enhancements#
For Windows#
- Fixed a bug where Docker Desktop failed to start (often on first boot) incorrectly believing another instance of the application is running. (docker/for-win#14294 and docker/for-win#14034).
4.34.0#
{ { < release-date date="2024-08-29" > } }
{ { < desktop-install-v2 all=true beta_win_arm=true version="4.34.0" build_path="/165256/" > } }
New#
- Host networking support on Docker Desktop is now generally available.
- If you authenticate via the CLI, you can now authenticate through a browser-based flow, removing the need for manual PAT generation.
- Windows now supports automatic reclamation of disk space in Docker Desktop for WSL2 installations using a managed virtual hard disk.
- Deploying Docker Desktop via the MSI installer is now generally available.
- Two new methods to enforce sign-in (windows registry key and
.plist
file) are now generally available. - Fresh installations of Docker Desktop now use the containerd image store by default.
- Compose Bridge (Experimental) is now available from the Compose file viewer. Easily convert and deploy your Compose project to a Kubernetes cluster.
Upgrades#
- Docker Engine v27.2.0
- Docker Compose v2.29.2
- containerd v1.7.20
- Docker Scout CLI v1.13.0
- Docker Buildx v0.16.2
- Linux kernel
v6.10.1
Bug fixes and enhancements#
For all platforms#
- Fixed a bug that caused the CLI to become idle when a container was started with AutoRemove (
--rm
) but whose port bindings would be rejected by Docker Dekstop at start-up. - Fixed a bug where diagnostics collection would fail sporadically on the Support screen.
- Fixed a bug where folders wouldn't expand in a container's File tab. Fixes docker/for-win#14204.
- In-app updates now respect the proxy settings.
- Extended the ECI Docker socket mount permissions feature to optionally child images derived from allowed images. This allows ECI to work with buildpacks (e.g., Paketo) that create ephemeral local images that use Docker socket mounts.
- Fixed a bug that caused the Containers view to flash when using certain proxy settings. Fixes docker/for-win#13972.
- Improved the output of
docker image list
to show multi-platform-related image information.
For Mac#
- Fixed a bug where a
Partial repair error
would occasionally appear when triggering the Configuration integrity check feature. - Configuration integrity check feature now shows information on why the Docker socket is mis-configured.
- Fixed an issue where the Configuration integrity check feature would report the system path instead of the user path if Docker Desktop is installed as
User
. - Fixed a bug where applications trying to read extended attributes from bind mounted volumes could experience failures. Fixes docker/for-mac#7377.
For Windows#
- Fixed a bug where Docker Desktop would reset docker's
credsStore
todesktop
when the user's intention is to keep it empty. Fixes docker/for-win#9843. - Fixed a bug that would cause Docker Desktop to not start in the WSL2 engine docker/for-win#14034.
- Fixed a bug that caused WSL distro to terminate abruptly. Fixes docker/for-win/14230.
- Fixed an issue that caused WSL to update in each startup. Fixes docker/for-win/13868, docker/for-win/13806.
Known issues#
- Compose Bridge does not work automatically when you enable it within the Experimental settings tab. It takes a few minutes before you are notified that you must 'repair' Docker Desktop which then installs the
compose-bridge
binary. - The Convert and Deploy button in the Compose file viewer might be disabled even when Kubernetes is running and Compose Bridge is enabled. The workaround for this is to disable Compose Bridge in the Experimental settings tab, apply the change with Apply & restart, then re-enable and select Apply & restart again.
- There is a known issue when authenticating against a registry in the Docker CLI (
docker login [registry address]
) where, if the provided registry address includes a repository/image name (such asdocker login index.docker.io/docker/welcome-to-docker
), the repository part (docker/welcome-to-docker
) is not normalized and results in credentials being stored incorrectly, which causes subsequent pulls from the registry (docker pull index.docker.io/docker/welcome-to-docker
) to not be authenticated. To prevent this, don't include any extraneous suffix in the registry address when runningdocker login
.[!NOTE] Using
docker login
with an address that includes URL path segments is not a documented use case and is considered unsupported. The recommended usage is to specify only a registry hostname, and optionally a port, as the address fordocker login
. - When running
docker compose up
and Docker Desktop is in the Resource Saver mode, the command is unresponsive. As a workaround, manually exit the Resource Saving mode and Docker Compose becomes responsive again. - When Enhanced Container Isolation (ECI) is enabled, Docker Desktop may not enter Resource Saver mode. This will be fixed in a future Docker Desktop release.
- The new ECI Docker socket mount permissions for derived images feature does not yet work when Docker Desktop is configured with the Use containerd for pulling and storing images. This will be fixed in the next Docker Desktop release.
4.33.1#
{ { < release-date date="2024-07-31" > } }
{ { < desktop-install-v2 win=true beta_win_arm=true version="4.33.0" build_path="/161083/" > } }
Bug fixes and enhancements#
For Windows#
- Added support for WSL2 2.3.11 and above, which includes loadable kernel modules. Fixes docker/for-win#14222
4.33.0#
{ { < release-date date="2024-07-25" > } }
{ { < desktop-install-v2 all=true beta_win_arm=true version="4.33.0" build_path="/160616/" > } }
New#
- Docker Debug is now generally available.
- BuildKit now evaluates Dockerfile rules to inform you of potential issues.
- Resource Allocation settings can now be accessed directly from the resource usage data displayed in the Dashboard footer.
Upgrades#
- Docker Compose v2.29.1
- Docker Engine v27.1.1
- containerd v1.7.19
- NVIDIA Container Toolkit v1.16.0
- Docker Scout CLI v1.11.0
- Kubernetes v1.30.2
- Linux kernel
v6.10
Bug fixes and enhancements#
For all platforms#
- Fixed an issue that caused containers started with
--net=host
and listening on an IPv6 address to be accessible from the host. - Improved the UX for enabling the containerd image store in the Settings tab.
- Fixed an issue that caused a deadlock seen while using the
grpcfuse
filesharing option under heavy load. - Fixed a bug where Mac-specific admin settings were impacting other platforms.
- IPv6 address blocks can now be specified in Docker Engine's
default-address-pools
. - Fixed an issue with the validation of the Docker Engine's
bip
,fixed-cidr
andfixed-cidr-v6
. Fixes docker/for-mac#7104. - Docker Engine's
default-network-opts
parameter is now properly validated. - VirtioFS performance improvements include increasing directory cache timeout, handling change notifications from the host, removing extra FUSE operations for security.capability attributes, optimizing host event detection, and providing an API to clean caches after container termination.
- Docker Desktop now notifies when there is a port conflict in a host networking container.
- Compose Bridge command line option is now available via Experimental features. When enabled, run
compose-bridge
to convert your Compose configuration to Kubernetes resources. - Builds view:
- Added build checks to the build details' Source tab.
- Added build tags to the build details' Info tab under the Source details section.
- Newly imported builds are now highlighted.
- Improved performance of error message handling.
- Fixed a connection issue to the builder which prevented build records from displaying.
- Fixed the navigation when opening builds through the CLI.
For Mac#
- The Configuration integrity check feature now provides more context around what has changed with your Docker Desktop configuration. For more information, see the FAQs.
- The Configuration integrity check feature shows an error when it fails to repair Docker Desktop.
- Fixed a bug where the IPv6 TCP was set to
host.docker.internal
. Fixes docker/for-mac#7332. - Fixed an issue where the
docker-compose
symlink pointed to an empty location. Fixes docker/for-mac#7345.
For Linux#
- Fixed an issue where some
wincred
values were persisted after uninstall. Reported by Javier Yong @Javiery3889. - Fixed an issue where the notification Another application changed your Desktop configurations is incorrectly triggered.
Security#
For all platforms#
- Includes a fix for AuthZ Plugin Bypass Regression in Docker Engine. For more information, see CVE-2024-41110.
For Windows#
- Fixed an issue where some
wincred
values were persisted after uninstall. Reported by Javier Yong @Javiery3889.
Known Issues#
For Windows#
- Docker Desktop fails to start with WSL pre-releases
v2.3.11.0
andv2.3.12.0
, which is included in Windows 11 Insider. To fix this ensure WSLv2.2.4.0
is installed. For more information, see microsoft/WSL#11794. This affects Docker Desktop 4.33.0 and earlier.
4.32.0#
{ { < release-date date="2024-07-04" > } }
{ { < desktop-install-v2 all=true beta_win_arm=true version="4.32.0" build_path="/157355/" > } }
New#
- Docker Engine and CLI updated to version 27.0.
- Docker Desktop now supports moving data to a different drive on macOS and Windows with WSL2 backend. See docker/for-win#13384.
- You can now schedule backups for volume exports in the Volumes tab (Beta).
- Access a terminal shell directly from Docker Desktop (Beta).
Upgrades#
- Docker Buildx v0.15.1
- Docker Compose v2.28.1
- Docker Scout CLI v1.10.0
- Docker Engine v27.0.3
- Docker Init v1.3.0
Bug fixes and enhancements#
For all platforms#
- Improved instructions for
watch
in the Compose File Viewer - Added support for Golang projects that don't have dependencies in Docker Init. Addresses docker/roadmap#611
- Settings Management now lets admins set the default value to
ProxyEnableKerberosNTLM
. - Removed a temporary compatibility fix for older versions of Visual Studio Code.
- Builds view:
- Changed icon for imported build record to a "files" icon.
- Improved the error message when trying to connect to an already connected Docker Build Cloud builder.
- Fixed an issue where build records would disappear unexpectedly.
- Fixed an issue that prevented users from being able to re-open an imported build.
- Fixed an issue where build details were not displayed when a build's state had changed from running to completed.
- Fixed malformed build source link in build details.
- Fixed missing build stats for named contexts.
- Fixed image index/manifest not being displayed anymore in build results.
- Fixed an issue where build traces exported from the UI would appear as a single, flattened list when imported to Jaeger
- Fixed truncated digest/sha in build details.
- Fixed final status animation of active builds.
For Windows#
- Fixed an issue on the WSL 2 engine where Docker Desktop would not detect the existence of the
docker-desktop-data
distribution if it had been manually moved by the user. - The Windows on ARM installer and the privileged service are now built for ARM64.
For Mac#
- Re-added
CONFIG_DM_CRYPT
kernel module. - Re-added
CONFIG_PSI
kernel module. - Re-added
CONFIG_GTP
kernel module. - Re-added
CONFIG_NFT_BRIDGE_META
kernel module. - Fixed a regression where the Another application changed your Desktop configuration warning message appeared whenever
/var/run/docker.socket
was pointing to an unexpected path. - Changed the Configuration Check menu entry and banner to a notification.
- Improved the performance of read and write operations on bind mounts.
- Fixed fatal errors with some
AMD64
Java images. Fixes docker/for-mac/7286 and docker/for-mac/7006. - Fixed an issue that caused Docker Desktop to remove
Docker.app
when installing from/Applications
. - Fixed an issue that caused bind mounts to fail. Fixes docker/for-mac#7274.
Known issues#
For all platforms#
- The Manage Synchronized File Shares with Compose setting is automatically enabled for all users who opt into Access experimental features. This converts all bind mounts into synchronized file shares. To disable this behavior, deselect Access experimental features. Then, manually delete any file shares by going to the File sharing tab within Resources, navigating to the Synchronized file shares section, selecting the file shares you want to remove, and selecting Delete.
For Mac#
- When running
docker-compose
after an update, it will returncommand not found
. As a workaround, you can create the following symlink:sudo ln -sf /Applications/Docker.app/Contents/Resources/cli-plugins/docker-compose /usr/local/bin/docker-compose
4.31.1#
{ { < release-date date="2024-06-10" > } }
{ { < desktop-install win=true beta_win_arm=true version="4.31.1" build_path="/153621/" > } }
Bug fixes and enhancements#
For Windows#
- Fixed a bug where containers, images and volumes created before the update were potentially invisible for users. Fixes docker/for-win#14118.
4.31.0#
{ { < release-date date="2024-06-06" > } }
{ { < desktop-install all=true beta_win_arm=true version="4.31.0" build_path="/153195/" > } }
New#
- Air-Gapped Containers is now generally available.
- Docker Compose File Viewer shows your Compose YAML with syntax highlighting and contextual links to relevant docs (Beta, progressive rollout).
- New Sidebar user experience.
Upgrades#
- Docker Engine and CLI v26.1.4.
- Docker Scout CLI v1.9.1
- Docker Compose v2.27.1
- Docker Buildx v0.14.1
- Containerd v1.6.33
- Credential Helpers v0.8.2
- NVIDIA Container Toolkit v1.15.0
- Go 1.22.4
- Linux kernel
v6.6.31
Bug fixes and enhancements#
For all platforms#
- Newer releases are now displayed in the Software updates settings tab when an update has already been downloaded.
- Added
proxyEnableKerberosNTLM
config tosettings.json
to enable fallback to basic proxy authentication if Kerberos/NTLM environment is not properly set up. - Fixed a bug where Docker Debug was not working properly with Enhanced Container Isolation enabled.
- Fixed a bug where UDP responses were not truncated properly.
- Fixed a bug where the Update screen was hidden when using Settings Management.
- Fixed a bug where proxy settings defined in
admin-settings.json
were not applied correctly on startup. - Fixed a bug where the Manage Synchronized file shares with Compose toggle did not correctly reflect the value with the feature.
- Fixed a bug where a bind mounted file modified on host is not updated after the container restarts, when gRPC FUSE file sharing is used on macOS and on Windows with Hyper-V. Fixes docker/for-mac#7274, docker/for-win#14060.
- Builds view:
- New Import builds feature that lets you import build records for builds by other people, or builds in a CI environment.
- Fixed missing OpenTelemetry traces in build results for failed builds.
- Fixed
default-load
appearing as invalid driver-opt for the container driver. - Fixed deep link to build details.
For Windows#
- Changed the
--allowed-org
installer flag to write a policy registry key instead of to theregistry.json
.
For Mac#
- Moved the setting Automatically check configuration from Advanced settings to General settings.
- Improved VirtioFS caching by implementing longer attributes timeout and invalidation.
For Linux#
- Added Linux headers to the VM, to ease the compilation of custom kernel modules.
Security#
For all platforms#
- Fixed a security bug in Enhanced Container Isolation (ECI) mode where a user could create Docker volumes sourced from restricted directories inside the Docker Desktop VM and mount them into containers, thereby giving the container access to such restricted VM directories.
- By default, only extensions listed in the marketplace can be installed in Docker Desktop. This can be changed in Docker Desktop's settings. Extension developers will need to change this option in order to test their extensions.
For Windows#
- Fixed CVE-2024-5652 in which a user in the
docker-users
group can cause a Windows Denial-of-Service through theexec-path
Docker daemon config option in Windows containers mode. This vulnerability was discovered by Hashim Jawad (@ihack4falafel) working with Trend Micro Zero Day Initiative.
Deprecation#
For all platforms#
- The CLI binary that used to be shipped as
com.docker.cli
is now shipped simply asdocker
. This release leaves the CLI binary ascom.docker.cli
, but it will be removed next release.
For Windows#
- Removed support for legacy version packs from the WSL2 engine.
Known Issues#
For Windows#
- When upgrading to Docker Desktop 4.31.0, existing containers, images and volumes become invisible for users that created those containers and images using Docker Desktop 4.8.0 or lower, on Windows hosts with WSL only. The data is not lost, it just becomes invisible to Docker Desktop 4.31.0. If impacted, downgrade to version 4.30 or earlier. For more information see: docker/for-win#14118.
For Linux#
- Ubuntu 24.04 LTS is not yet supported, Docker Desktop will fail to start. Due to a change in how the latest Ubuntu release restricts the unprivileged namespaces,
sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
needs to be ran at least once. Refer to the Ubuntu Blog.
4.30.0#
{ { < release-date date="2024-05-06" > } }
{ { < desktop-install all=true beta_win_arm=true version="4.30.0" build_path="/149282/" > } }
New#
For all platforms#
- Docker Desktop now supports SOCKS5 proxies. Requires a Business subscription.
- Added a new setting to manage the onboarding survey in Settings Management.
For Windows#
- Added support for Kerberos and NTLM proxy authentication on Windows. Requires a Business subscription.
Upgrades#
- Docker Compose v2.27.0
- Docker Engine v26.1.1
- Wasm runtimes:
- Updated
runwasi
shims tov0.4.0
- Updated
deislabs
shims tov0.11.1
- Updated
spin
shim tov0.13.1
- Docker Scout CLI v1.8.0
- Docker Debug
v0.0.29
- Linux kernel
v6.6.26
- Go 1.22.2
Bug fixes and enhancements#
For all platforms#
- Improved Enhanced Container Isolation (ECI) security when running
docker build
commands in rootless containers. - Fixed a bug where
docker events
exited withUnexpected EOF
when Docker Desktop entered/exited Resource Saver mode. - Fixed a bug where
docker stats --no-stream
hung when Docker Desktop was in Resource Saver mode. - Fixed a bug in the self-diagnose CLI that incorrectly showed the VM had not started. Fixes docker/for-mac#7241.
- Fixed a bug where high-throughput port forward transfers could stall. Fixes docker/for-mac#7207.
- Fixed CLI-plugin symlinks not being removed when CLI apps were removed.
- Fixed a bug in the shared ports drawer to show the right message for local engines.
- Dev Environments is being sunset and has moved to the Beta tab in Features in development.
- Builds view:
- Better bulk delete for build records.
- Added action to open the relevant web page for container images and Git sources in build dependencies.
- Added action to download Provenance and OpenTelemetry traces in Jaeger or OTLP format.
- Fixed source details for remote build invocations.
- Fixed a bug where multi-platform builds would show up as separate records when using a cloud builder.
For Mac#
- Fixed a bug where a segmentation fault was triggered with Virtualization Framework, on post-2019 Macs. See docker/for-mac#6824.
- Enabled
CONFIG_SECURITY=y
kernel config, for example for Tetragon. Fixes docker/for-mac#7250. - Re-added support for
SQUASHFS
compression. Fixes docker/for-mac#7260. - Fixed a bug that caused a new version of Docker Desktop to be marked as damaged.
- Increased network MTU when using qemu on Apple Silicon.
- Fixed a bug preventing Docker Desktop to start if Rosetta was not installed. Fixes docker/for-mac#7243.
For Windows#
- Added a simplified provisioning mode for WSL2 that avoids the need for the ancillary
docker-desktop-data
WSL distribution (experimental). - Fixed bash completions for the Docker CLI in a WSL environment.
- Fixed a regression in Docker Desktop 4.28 that caused host files bind-mounted into containers to not show up properly inside the container, when using Docker-in-Docker (via mounts of
/var/run/docker.sock
) on WSL. - Fixed a bug that would cause the following error
merging settings: integratedWslDistros type mismatch
.
Known issues#
For all platforms#
- If you have enabled a feature in Docker Desktop that requires you to be signed in, such as Host networking you must remain signed in to use Docker Desktop. To continue using Docker Desktop or to modify these settings, ensure you are signed in.
- To enable or disable Manage Synchronized file shares with Compose, Access experimental features and Manage Synchronized file shares with Compose have to be checked or unchecked at the same time.
- The Docker CLI will sometimes hang when running a container with the autoremove option (
--rm
) if the container fails to start (e.g.:docker run --rm alpine invalidcommand
). In this case, the CLI process may need to be manually killed.
For Windows#
- When starting Docker Desktop as a non-admin user, the following error connect
ENOENT \\.\pipe\errorReporter
might be triggered if the user is not a member of the docker-users group. This can be resolved by adding the user to the docker-users group. Before starting Docker Desktop, make sure to sign out and then sign back in and unregisterdocker-desktop
distribution if that was created, usingwsl --unregister docker-desktop
.
For Linux#
- Ubuntu 24.04 LTS is not yet supported, Docker Desktop will fail to start. Due to a change in how the latest Ubuntu release restricts the unprivileged namespaces,
sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
needs to be ran at least once. Refer to the Ubuntu Blog for more details.
4.29.0#
{ { < release-date date="2024-04-08" > } }
{ { < desktop-install all=true version="4.29.0" build_path="/145265/" > } }
New#
- You can now enforce Rosetta usage via Settings Management.
- Docker socket mount restrictions with ECI is now generally available.
- Docker Engine and CLI updated to Moby 26.0. This includes Buildkit 0.13, sub volumes mounts, networking updates, and improvements to the containerd multi-platform image store UX.
- New and improved Docker Desktop error screens: swift troubleshooting, easy diagnostics uploads, and actionable remediation.
- Compose supports Synchronized file shares (experimental).
- New interactive Compose CLI (experimental).
- Beta release of:
- Air-Gapped Containers with Settings Management.
- Host networking in Docker Desktop.
- Docker Debug for running containers.
- Volumes Backup & Share extension functionality available in the Volumes tab.
Upgrades#
- Docker Compose v2.26.1
- Docker Scout CLI v1.6.3
- Docker Engine v26.0.0
- Buildx v0.13.1
- Kubernetes v1.29.2
- cri-dockerd v0.3.11
- Docker Debug v0.0.27
Bug fixes and enhancements#
For all platforms#
- Fixed an issue with dropdown menu opening beyond the application window.
- Docker Init:
- Updated the formatting of CLI output to improve legibility.
- Fixed an issue with
.dockerignore
to avoid ignoring application files that start with "compose". - Improved how Java applications are started based on Spring Boot version. Fixes docker/for-mac#7171.
- Removed non-official Docker image used for Rust cross-compilation.
- The maximum number of files per Synchronized file share now exceeds 2 million.
- Fixed an issue that caused the warning: "The value provided to Autocomplete is invalid." when selecting the Export to local image field.
- Run Cloud can now be accessed from the Docker Dashboard.
- Opting out from sending analytics will now also disable collecting data for bug reports.
- You can now share and unshare a port to the Cloud Engine in the Containers view.
- Shared cloud can now be accessed from the footer in the right-hand side of the Dashboard.
- Added beta support for host networking on macOS, Windows and Docker Desktop for Linux docker#238.
- Added a timestamp to new unread notifications.
- Fixed typo in the virtualization support error message. Fixes docker/desktop-linux#197.
- Docker Desktop now allows connections to
host.docker.internal
to be blocked by a rule in a PAC file. - Fixed the placement of the secondary menu in the Images and Containers lists.
- Fixed a race condition that occurred when starting Docker Desktop with QEMU.
- Improved the error message when an image pull is blocked by Registry Access Management policy.
- Re-add
CONFIG_BONDING=y
in the kernel config.
For Mac#
- Fixed Kubernetes not starting successfully. Fixes docker/for-mac#7136 and docker/for-mac#7031.
- Fixed a bug when the browser was not able to send back authentication information to Docker Desktop. Fixes docker/for-mac/issues#7160.
For Windows#
- Fixed a bug where
docker run -v
would fail after switching between WSL 2 and Hyper-V. - Fixed a bug where Docker Desktop was not stopping its WSL distros (
docker-desktop
anddocker-desktop-data
) when it was shutdown. Fixes docker/for-win/issues/13443 and docker/for-win/issues/13938.
For Linux#
- Fixed an issue that caused the list of available experimental features in the UI to become out-of-sync with the backend data.
Security#
- Disabled Electron
runAsNode
fuse to improve security hardening. For more info, see Electron's documentation.. - Fixed CVE-2024-6222 which allows an attacker who has gained access to the Docker Desktop VM through a container breakout to further escape to the host by passing extensions and dashboard related IPC messages. Reported by Billy Jheng Bing-Jhong, Đỗ Minh Tuấn, Muhammad Alifa Ramdhan working with Trend Micro Zero Day Initiative.
Known issues#
For Mac#
- Docker Desktop on Apple Silicon doesn't start if Rosetta is not installed. This will be fixed in future releases. See docker/for-mac#7243.
4.28.0#
{ { < release-date date="2024-02-26" > } }
{ { < desktop-install all=true version="4.28.0" build_path="/139021/" > } }
New#
- Settings Management now allows admins to set the default file-sharing implementation and specify which paths developer can add file shares to.
- Added support for
socks5://
HTTP and HTTPS proxy URLs when theSOCKS
proxy support beta feature is enabled. - Users can now filter volumes to see which ones are in use in the Volumes tab.
Upgrades#
- Compose v2.24.6
- Docker Engine v25.0.3
- Docker Scout CLI v1.5.0
- Qemu 8.1.5
- Wasm runtimes:
- Updated runwasi shims to
v0.4.0
, including:- wasmtime
v17.0
, with initial support for WASI preview 2 - wasmedge
v0.13.5
- wasmer
v4.1.2
- wasmtime
- Updated deislabs shims to
v0.11.1
, including:- lunatic
v0.13.2
- slight
v0.5.1
- spin
v2.2.0
- wws
v1.7.0
- lunatic
Bug fixes and enhancements#
For all platforms#
- Fixed
postgis
withQemu
. Fixes docker/for-mac#7172. - Re added
CONFIG_BLK_DEV_DM
kernel config forkpartx
. Fixes docker/for-mac#7197. - Allow
SOCKS
proxies to be set via a proxy autoconfigpac file
. - Re added
CONFIG_AUDIT
kernel config. - Fixed a bug with the Rust build on
virtiofs
. See rust-lang/docker-rust#161. - Fixed an issue that caused the
missing registry authentication
error when pulling Kubernetes images. - Fixed an issue that caused Docker Compose commands to hang.
- Fixed a bug in
docker build
that caused Docker Desktop to crash. Fixes docker/for-win#13885, docker/for-win#13896, docker/for-win#13899, docker/for-mac#7164, docker/for-mac#7169 - Docker Init:
- Improved how Java applications are started based on Spring Boot version. Fixes docker/for-mac#7171.
- Removed non-official Docker image used for Rust cross-compilation
- Builds view:
- Active and completed builds can be found in dedicated tabs.
- Build details now displays build duration and cache steps.
- OpenTelemetry traces are now displayed in the build results.
- Fixed an issue where context builders events were not always triggered.
- Restyle the empty state view to make the dashboard clearer.
For Mac#
- Fix
httpd
issue with Rosetta. docker/for-mac#7182 - Fixed a bug that caused a crash on the
virtualization.framework
. Fixes docker/for-mac#7024
For Windows#
- Fixed an issue with DNS timeouts on Windows.
- Added support for Enhanced Container Isolation Docker socket mount permission on WSL user distros.
- Fixed an issue that caused the
failed to get console mode
error when redirecting output from the CLI. - Fixed an issue with the engine socket permissions when mounted inside containers. Fixes docker/for-win#13898
Known Issues#
For Windows#
- In dark mode, the Disk image location in Resources>Advanced settings is not visible. As a workaround, change to light mode.
4.27.2#
{ { < release-date date="2024-02-08" > } }
{ { < desktop-install all=true version="4.27.2" build_path="/137060/" > } }
Upgrades#
- Compose v2.24.5
- Docker Scout CLI v1.4.1
- Docker Debug v0.0.24
Bug fixes and enhancements#
For all platforms#
- Fixed a bug where the diagnostics ID would not print correctly when uploading diagnostics from the terminal.
- Fixed a bug where the default settings values were being reset to default on startup, when using Settings Management.
- Fixed a bug with the dashboard being shown at startup even though the Open Docker Dashboard when Docker Desktop starts option was disabled. Fixes docker/for-win#13887.
- Fixed a bug in the build backend service that caused Docker Desktop to crash. Fixes docker/for-win#13885, docker/for-win#13896, docker/for-win#13899, docker/for-mac#7164, docker/for-mac#7169.
- Fixed the Docker Engine socket permissions when mounted inside containers. Fixes docker/for-win#13898.
- Docker Scout:
- Updated dependencies to address Leaky Vessels series of CVEs (CVE-2024-21626, CVE-2024-24557)
- Added initial VEX document to document false positive CVE-2020-8911 and CVE-2020-8912
- Added support for cosign SBOM attestations
- Added support for VEX in-toto attestations
- Docker Debug:
- Fixed a bug when pulling the image behind resource accesses management
- Fixed connection issues
For Mac#
- Re-added kernel modules needed by
Istio
. Fixes docker/for-mac#7148. - Node now uses all the cores available under Rosetta.
- Fixed an issue with
php-fpm
. Fixes docker/for-mac#7037.
4.27.1#
{ { < release-date date="2024-02-01" > } }
{ { < desktop-install all=true version="4.27.1" build_path="/136059/" > } }
Upgrades#
- Docker Engine v25.0.2 which contains a fix for CVE-2024-24557, CVE-2024-23650, CVE-2024-23651, CVE-2024-23652 and CVE-2024-23653
- Containerd v1.6.28
- Runc v1.1.12 which contains a fix for CVE-2024-21626
Bug fixes and enhancements#
For Mac#
- Fixed a bug that caused Docker Desktop to hang when applying an update.
4.27.0#
{ { < release-date date="2024-01-25" > } }
{ { < desktop-install all=true version="4.27.0" build_path="/135262/" > } }
New#
- Docker init now supports Java and is generally available to all users.
- Synchronized File Shares provides fast and flexible host-to-VM file sharing within Docker Desktop. Utilizing the technology behind Docker’s acquisition of Mutagen, this feature provides an alternative to virtual bind mounts that uses synchronized filesystem caches, improving performance for developers working with large codebases.
- Organization admins can now configure Docker socket mount permissions when ECI is enabled.
- Containerd Image Store support is now generally available to all users.
- Get a debug shell into any container or image with the new
docker debug
command (Beta). - Organization admins, with a Docker Business subscription, can now configure a custom list of extensions with Private Extensions Marketplace enabled (Beta)
Upgrades#
- Amazon ECR Credential Helper v0.7.1
- Buildx v0.12.1
- Containerd v1.6.27
- Compose v2.24.3
- Docker Credential Helpers v0.8.1
- Runc v1.1.11
- Docker Engine v25.0.0
- Kubernetes v1.29.1
- Docker Scout v1.3.0
Bug fixes and enhancements#
For all platforms#
- The
docker scan
command has been removed. To continue learning about the vulnerabilities of your images, and many other features, use thedocker scout
command. - Fixed a bug where automatic updates would not download when the Always download updates checkbox was selected.
- Fixed typo in the dashboard tooltip. Fixes docker/for-mac#7132
- Improved signal handling behavior (e.g. when pressing Ctrl-C in the terminal while running a
docker
command). - Re-added kernel modules required by
minikube start --cni=cilium
. - Fixed a bug that caused the installation screen to appear again when admin controls are enabled after sign in.
- Fixed a bug where Docker would not start if a shared folder is no longer present.
- Fixed the number of available CPUs displayed in the Containers section of the Dashboard.
- Re-added kernel modules for
btrfs
,xfs
,vfat
,exfat
,ntfs3
,f2fs
,squashfs
,udf
,9p
andautofs
. - Container usage charts have been moved to a vertical Resource usage side panel to allow for more space in the containers list. Accessing the usage charts remains the same via the Show charts button.
- Fixed a bug where selecting Close Application at sign-in was leaving behind a hung backend process.
- Fixed a bug which caused Docker Desktop to become unresponsive when analytics is disabled through Settings Management.
- Docker init:
- Added support for containerizing a Java server
- Various fixes on Windows
- Builder settings:
- You can now refresh storage data for your builder at any point in time.
- You can now delete the build history for a builder.
- Builds view:
- An error message is now shown when a build record cannot be removed.
- Fixed an issue where a cloud builder could not be created in rootless mode on macOS.
- Inline cache and Git source are now properly handled in the Build timing section of the Info tab.
- The Builder used and the author invoking the build is now displayed in past builds on the History tab.
- Several improvements made to better link past builds on the History tab.
- Several improvements to make the build name more accurate.
- Fixed stuck builds in the Active builds list when a builder cannot be reached.
- Fixed an issue preventing the build record from being deleted in some circumstances.
- Fixed an issue where build names could be empty.
- Fixed a general issue with the Builds view when Resource saver mode is enabled.
For Mac#
- Enabled
Huge Pages
and fixed PHP segmentation fault with Rosetta. Fixes docker/for-mac#7117. - Fixed
xvfb
under Rosetta. Fixes docker/for-mac#7122 - Fixed
ERR_WORKER_INVALID_EXEC_ARGV
error under Rosetta. docker/for-mac#6998. - Fixed a bug where Docker Desktop could deadlock if
admin-settings.json
was syntactically invalid.
For Windows#
- Fixed a bug that prevented UTF-16 strings from being encoded to UTF-8 for some locales. Fixes docker/for-win#13868.
- Fixed a bug where the credentials store configuration would reset on app restart with the WSL integration. Fixes docker/for-win#13529.
- Fixed an issue that prevented the correct WSL engine errors from propagating to the user.
- Fixed an issue that would cause Docker Desktop to hang when quitting from Windows Containers mode.
Security#
For Windows#
- Mitigated several DLL side-loading vulnerabilities in the Docker Desktop installer on Windows, reported by Suman Kumar Chakraborty (@Hijack-Everything)
Known issues#
For all platforms#
- When using Setting Management, the settings that are not set in the
admin-settings.json
will be reset to default when Docker Desktop starts.
For Mac#
- Updating to 4.27.0 from the Software updates sometimes hangs. As a workaround, use the 4.27.0 installer from this page.
4.26.1#
{ { < release-date date="2023-12-14" > } }
{ { < desktop-install all=true version="4.26.1" build_path="/131620/" > } }
Bug fixes and enhancements#
For all platforms#
- Updated feedback links inside Docker Desktop to ensure they continue to work correctly
For Windows#
- Switch the CLI binaries to a version compatible with older versions of glibc, such as used in Ubuntu 20.04 fixes docker/for-win#13824
4.26.0#
{ { < release-date date="2023-12-04" > } }
{ { < desktop-install all=true version="4.26.0" build_path="/130397/" > } }
New#
- Administrators can now control access to beta and experimental features in the Features in development tab with Settings Management.
- Introduced four new version update states in the footer.
docker init
(Beta) now supports PHP with Apache + Composer.- The Builds view is now GA. You can now inspect builds, troubleshoot errors, and optimize build speed.
Upgrades#
- Compose v2.23.3
- Docker Scout CLI v1.2.0.
- Buildx v0.12.0
- Wasm runtimes:
- wasmtime, wasmedge and wasmer
v0.3.1
. - lunatic, slight, spin, and wws
v0.10.0
. - Wasmtime is now based on wasmtime
v14.0
and supports wasi preview-2 components - Wasmedge is now based on WasmEdge
v0.13.5
- Spin is now based on Spin
v2.0.1
- wws is now based on wws
v1.7.0
- Docker Engine v24.0.7
- Containerd v1.6.25
- runc v1.1.10
Bug fixes and enhancements#
For all platforms#
- You can now provide feedback from the commandline by using
docker feedback
. - Improved the text and position of the startup options in the General settings tab.
- Redesigned the dashboard's header bar, added links to other Docker resources, improved display of account information.
- Fixed a bug where enabling the containerd image store and Wasm simultaneously would not enable Wasm.
- containerd integration:
- Fixed
docker push/pull
authentication not being sent to non-DockerHub registries in cases whereServerAddress
is not provided. - Fixed
docker history
reporting wrong IDs and tags. - Fixed
docker tag
not preserving internal metadata. - Fixed
docker commit
when the daemon configured with--userns-remap
. - Fixed
docker image list
to show real image creation date. - Added support for
-a
flag todocker pull
(pull all remote repository tags). - Added support for
--group-add
flag todocker run
(append extra groups). - Adjusted some errors reported by
docker push/pull
. - Docker Init:
- Improved cross-compilation in Dockerfiles for Golang and Rust.
- Improved caching in Dockerfile for ASP.NET Core.
- Docker Desktop now gives more detailed information about pending updates in the dashboard footer.
- Fixed a bug in Enhanced Container Isolation mode where
docker run --init
was failing. - Fixed a bug where a notification prompting the user to download a new version of Docker Desktop remained visible after the user started downloading the new version.
- Added a notification that indicates when Docker Desktop is installing a new version.
- Fixed a bug where the cursor changed to a pointer when the user hovered over a notification that has no call to action.
For Mac#
- Fixed an issue where Rosetta would not work with PHP. Fixes docker/for-mac#6773 and docker/for-mac#7037.
- Fixed several issues related to Rosetta not working. Fixed [docker/for-mac#6973, [docker/for-mac#7009, [docker/for-mac#7068 and [docker/for-mac#7075
- Improved the performance of NodeJS under Rosetta.
- Fixed the Unable to open /proc/self/exe Rosetta errors.
- Fixed a bug were the setting Start Docker Desktop when you sign in would not work. Fixes docker/for-mac#7052.
- You can now enable the use of Kernel networking path for UDP through the UI. Fixes docker/for-mac#7008.
- Fixed a regression where the
uninstall
CLI tool was missing. - Addressed an issue which caused Docker Desktop to become unresponsive when analytics were disabled with Settings Management.
For Windows#
- Added support for WSL mirrored mode networking (requires WSL
v2.0.4
and up). - Added missing signatures on DLL and VBS files.
Known issues#
For Windows#
- Docker CLI doesn’t work when using WSL 2 integration on an older Linux distribution (for example, Ubuntu 20.04) which uses a
glibc
version older than2.32
. This will be fixed in future releases. See docker/for-win#13824.
4.25.2#
{ { < release-date date="2023-11-21" > } }
{ { < desktop-install all=true version="4.25.2" build_path="/129061/" > } }
Bug fixes and enhancements#
For all platforms#
- Fixed a bug where a blank UI would appear after submitting a response in the Welcome Survey.
For Windows#
- Fixed a bug where Docker Desktop on WSL 2 would shut down dockerd unexpectedly when idle. Fixes docker/for-win#13789
4.25.1#
{ { < release-date date="2023-11-13" > } }
{ { < desktop-install all=true version="4.25.1" build_path="/128006/" > } }
Bug fixes and enhancements#
For all platforms#
- Fixed a regression in 4.25 where Docker would not start if the swap file was corrupt. Corrupt swap files will be re-created on next boot.
- Fixed a bug when swap is disabled. Fixes docker/for-mac#7045, docker/for-mac#7044 and docker/for-win#13779.
- The
sysctl vm.max_map_count
is now set to 262144. See docker/for-mac#7047
For Windows#
- Fixed an issue where Switch to Windows Containers would not appear on the tray menu for some users. See docker/for-win#13761.
- Fixed a bug where the WSL integration would not work for users using a shell other than
sh
. See docker/for-win#13764. - Re-added
DockerCli.exe
.
4.25.0#
{ { < release-date date="2023-10-26" > } }
{ { < desktop-install all=true version="4.25.0" build_path="/126437/" > } }
New#
- Rosetta is now Generally Available for all users on macOS 13 or later. It provides faster emulation of Intel-based images on Apple Silicon. To use Rosetta, see Settings. Rosetta is enabled by default on macOS 14.1 and later.
- Docker Desktop now detects if a WSL version is out of date. If an out dated version of WSL is detected, you can allow Docker Desktop to automatically update the installation or you can manually update WSL outside of Docker Desktop.
- New installations of Docker Desktop for Windows now require a Windows version of 19044 or later.
- Administrators now have the ability to control Docker Scout image analysis in Settings Management.
Upgrades#
- Compose v2.23.0
- Docker Scout CLI v1.0.9.
- Kubernetes v1.28.2
- cri-dockerd v0.3.4
- CNI plugins v1.3.0
- cri-tools v1.28.0
Bug fixes and enhancements#
For all platforms#
- Fixed a spacing problem in the
Accept License
pop-up. - Fixed a bug where the Notifications drawer changed size when navigating between Notifications list and Notification details view.
- containerd integration:
docker push
now supportsLayer already exists
andMounted from
progress statuses.docker save
is now able to export images from all tags of the repository.- Hide push upload progress of manifests, configs and indexes (small json blobs) to match the original push behavior.
- Fixed
docker diff
containing extra differences. - Fixed
docker history
not showing intermediate image IDs for images built with the classic builder. - Fixed
docker load
not being able to load images from compressed tar archives. - Fixed registry mirrors not working.
- Fixed
docker diff
not working correctly when called multiple times concurrently for the same container. - Fixed
docker push
not reusing layers when pushing layers to different repositories on the same registry. - Docker Init:
- Fixed outdated links to Docker documentation included in generated files
- Add support for ASP.NET Core 8 (in addition to 6 and 7)
- Fixed a bug that caused a failure when installing Wasm shims.
- Fixed a bug where Docker Desktop exits the Resource Saver mode every 15 minutes, or, if the timer is set above 15 minutes, the resource saver mode never kicks in.
- Promoted the Enable background SBOM indexing option to General settings.
For Mac#
- Minimum OS version to install or update Docker Desktop on macOS is now macOS Monterey (version 12) or later.
- Enhanced error messaging when an update cannot be completed if the user doesn't match the owner of
Docker.app
. Fixes docker/for-mac#7000. - Fixed a bug where Re-apply configuration might not work when
/var/run/docker.sock
is mis-configured. - Docker Desktop doesn't overwrite
ECRCredentialHelper
if already present in/usr/local/bin
.
For Windows#
- Fixed an issue where Switch to Windows Containers would show in the tray menu on Windows Home Editions. Fixes docker/for-win#13715
For Linux#
- Fixed a bug in
docker login
. Fixes docker/docker-credential-helpers#299
Known Issues#
For Mac#
- Upgrading to MacOS 14 can cause Docker Desktop to also update to a latest version even if the auto update option is disabled.
- Uninstalling Docker Desktop from the command line is not available. As a workaround, you can uninstall Docker Desktop from the Dashboard.
For Windows#
- Switch to Windows containers option in the tray menu may not show up on Windows. As a workaround, edit the
settings.json
file and set"displaySwitchWinLinContainers": true
.
For all platforms#
- Docker operations, such as pulling images or logging in, fail with 'connection refused' or 'timeout' errors if the Swap file size is set to 0MB. As a workaround, configure the swap file size to a non-zero value in the Resources tab in Settings.
4.24.2#
{ { < release-date date="2023-10-12" > } }
{ { < desktop-install all=true version="4.24.2" build_path="/124339/" > } }
Bug fixes and enhancements#
For all platforms#
- Fixed a bug where Docker Desktop would send multiple requests to
notify.bugsnag.com
. Fixes docker/for-win#13722. - Fixed a performance regression for PyTorch.
4.24.1#
{ { < release-date date="2023-10-04" > } }
{ { < desktop-install win=true version="4.24.1" build_path="/123237/" > } }
Bug fixes and enhancements#
For Windows#
- Fixed a bug on Docker Desktop for Windows where the Docker Dashboard wouldn't display container logs correctly. Fixes docker/for-win#13714.
4.24.0#
{ { < release-date date="2023-09-28" > } }
{ { < desktop-install all=true version="4.24.0" build_path="/122432/" > } }
New#
- The new Notification center is now available to all users so you can be notified of new releases, installation progress updates, and more. Select the bell icon in the bottom-right corner of the Docker Dashboard to access the notification center.
- Compose Watch is now available to all users. For more information, see Use Compose Watch.
- Resource Saver is now available to all users and is enabled by default. To configure this feature, navigate to the Resources tab in Settings. For more information see Docker Desktop's Resource Saver mode.
- You can now view and manage the Docker Engine state, with pause, stop, and resume, directly from the Docker Dashboard.
Upgrades#
- Compose v2.22.0
- Go 1.21.1
- Wasm runtimes:
- wasmtime, wasmedge
v0.2.0
. - lunatic, slight, spin, and wws
v0.9.1
. - Added wasmer wasm shims.
Bug fixes and enhancements#
For all platforms#
- Docker Init:
- Fixed an issue formatting Dockerfile file paths for ASP.NET projects on Windows.
- Improved performance on language detection for large directories with lots of files.
- Added a timeout to polling for resource usage stats used by the Containers view. Fixes docker/for-mac#6962.
- containerd integration:
- Implemented push/pull/save image events.
- Implemented pulling legacy schema1 images.
- Implemented
docker push --all-tags
. - Implemented counting containers using a specific image (visible for example in
docker system df -v
). - Validated pulled image names are not reserved.
- Handle
userns-remap
daemon setting. - Fixed legacy builder build errors when multiple COPY/ADD instructions are used.
- Fixed
docker load
causing pool corruption which could some subsequent image related operations. - Fixed not being able to reference images via truncated digest with a
sha256:
prefix. - Fixed
docker images
(without--all
) showing intermediate layers (created by the legacy classic builder). - Fixed
docker diff
containing extra differences. - Changed
docker pull
output to match the output with containerd integration disabled. - Fixed a grammatical error in Kubernetes status message. See docker/for-mac#6971.
- Docker containers now use all host CPU cores by default.
- Improved inter-process security in dashboard UI.
For Mac#
- Fixed a kernel panic on Apple silicon Macs with macOS version below 12.5. Fixes docker/for-mac#6975.
- Fixed a bug where Docker Desktop failed to start if invalid directories were included in
filesharingDirectories
. Fixes docker/for-mac#6980. - Fixed a bug where installer is creating root-owned directories. Fixes docker/for-mac#6984.
- Fixed a bug where installer is failing on setting up the docker socket when missing
/Library/LaunchDaemons
. Fixes docker/for-mac#6967. - Fixed a permission denied error when binding a privileged port to a non-localhost IP on macOS. Fixes docker/for-mac#697.
- Fixed a resource leak introduced in 4.23. Related to docker/for-mac#6953.
For Windows#
- Fixed a bug where a "Docker Desktop service not running" popup appeared when service is already running. See docker/for-win#13679.
- Fixed a bug that caused Docker Desktop fail to start on Windows hosts. Fixes docker/for-win#13662.
- Modified the Docker Desktop resource saver feature to skip reducing kernel memory on WSL when no containers are running, as this was causing timeouts in some cases. Instead, users are encouraged to enable "autoMemoryReclaim" on WSL directly via the .wslconfig file (available since WSL 1.3.10).
Known issues#
For Mac#
- Creating a container with the port 53 fails with the error address
already in use
. As a workaround, deactivate network acceleration by adding"kernelForUDP": false
, in thesettings.json
file located at~/Library/Group Containers/group.com.docker/settings.json
.
4.23.0#
{ { < release-date date="2023-09-11" > } }
Upgrades#
- Compose v2.21.0
- Docker Engine v24.0.6
- Docker Scout CLI v0.24.1.
- Wasm runtimes:
- wasmtime, wasmedge revision
d0a1a1cd
. - slight and spin wasm
v0.9.0
.
New#
- Added support for new Wasm runtimes: wws and lunatic.
docker init
now supports ASP.NET- Increased performance of exposed ports on macOS, for example with
docker run -p
.
Removed#
- Removed Compose V1 from Docker Desktop as it has stopped receiving updates. Compose V2 has replaced it and is now integrated into all current Docker Desktop versions. For more information, see Migrate to Compose V2.
Bug fixes and enhancements#
For all platforms#
- With Docker Scout, you can now:
- Manage temporary and cached files with
docker scout cache
. - Manage environments with
docker scout environment
. - Configure the default organization with
docker scout config
. - List packages of an image with their vulnerabilities with
docker scout cves --format only-packages
. - Enroll an organization with Docker scout with
docker scout enroll
. - Stop, analyze, and compare local file systems with
docker scout cves --type fs
. - Fixed a bug where
docker stats
would hang when Docker Desktop was in Resource Saver mode. - Fixed a bug where turning off experimental features via Settings in the Docker Dashboard would not fully turn off Resource Saver mode.
- Fixed a bug where the Containers list action button was clipped.
- containerd image store:
- Fixed
failed to read config content
error when interacting with some images. - Fixed building Dockerfiles with
FROM scratch
instruction when using the legacy classic builder (DOCKER_BUILDKIT=0
). - Fixed
mismatched image rootfs errors
when building images with legacy classic builder (DOCKER_BUILDKIT=0
). - Fixed
ONBUILD
andMAINTAINER
Dockerfile instruction - Fixed healthchecks.
For Mac#
- All users on macOS 12.5 or greater now have VirtioFS turned on by default. You can revert this in Settings in the General tab.
- Improved single-stream TCP throughput.
- Reinstated the health check for macOS that notifies you if there has been a change on your system which might cause problems running Docker binaries.
For Linux#
- Fixed a bug where the GUI is killed when opening the Docker Desktop app twice. See docker/desktop-linux#148.
For Windows#
- Fixed a bug where non-admin users would get prompted for credentials when switching to Windows Containers or after disabling WSL and switching to the Hyper-V engine. This issue would occur after an OS restart, or on a cold start of Docker Desktop.
Security#
For all platforms#
- Fixed CVE-2023-5165 which allows Enhanced Container Isolation bypass via debug shell. The affected functionality is available for Docker Business customers only and assumes an environment where users are not granted local root or Administrator privileges.
- Fixed CVE-2023-5166 which allows Access Token theft via a crafted extension icon URL.
Known Issues#
- Binding a privileged port on Docker Desktop does not work on macOS. As a workaround you can expose the port on all interfaces (using
0.0.0.0
) or using localhost (using127.0.0.1
).
4.22.1#
{ { < release-date date="2023-08-24" > } }
Bug fixes and enhancements#
For all platforms#
- Mitigated several issues impacting Docker Desktop startup and Resource Saver mode. docker/for-mac#6933
For Windows#
- Fixed
Clean / Purge data
troubleshoot option on Windows. docker/for-win#13630
4.22.0#
{ { < release-date date="2023-08-03" > } }
Upgrades#
[!NOTE]
In this release, the bundled Docker Compose and Buildx binaries show a different version string. This relates to our efforts to test new features without causing backwards compatibility issues.
For example,
docker buildx version
outputsbuildx v0.11.2-desktop.1
.
New#
- Resource Usage has moved from experimental to GA.
- You can now split large Compose projects into multiple sub-projects with
include
.
Bug fixes and enhancements#
For all platforms#
- Settings Management now lets you turn off Docker Extensions for your organisation.
- Fixed a bug where turning on Kubernetes from the UI failed when the system was paused.
- Fixed a bug where turning on Wasm from the UI failed when the system was paused.
- Bind mounts are now shown when you inspect a container.
- You can now download Wasm runtimes when the containerd image store is enabled.
- With Quick Search, you can now:
- Find any container or Compose app residing on your local system. In addition, you can access environment variables and perform essential actions such as starting, stopping, or deleting containers.
- Find public Docker Hub images, local images, or images from remote repositories.
- Discover more about specific extensions and install them.
- Navigate through your volumes and gain insights about the associated containers.
- Search and access Docker's documentation.
For Mac#
- Fixed a bug that prevented Docker Desktop from starting. docker/for-mac#6890
- Resource Saver is now available on Mac. It optimises Docker Desktop's usage of your system resources when no containers are running. To access this feature, make sure you have turned on access to experimental features in settings.
For Windows#
- Fixed a bug where the self-diagnose tool showed a false-positive failure when vpnkit is expected to be not running. Fixes docker/for-win#13479.
- Fixed a bug where an invalid regular expression in the search bar caused an error. Fixes docker/for-win#13592.
- Resource Saver is now available on Windows Hyper-V. It optimises Docker Desktop's usage of your system resources when no containers are running. To access this feature, make sure you have turned on access to experimental features in settings.
4.21.1#
{ { < release-date date="2023-07-03" > } }
For all platforms#
- Fixed connection leak for Docker contexts using SSH (docker/for-mac#6834 and docker/for-win#13564)
For Mac#
- Removed configuration health check for further investigation and addressing specific setups.
4.21.0#
{ { < release-date date="2023-06-29" > } }
New#
- Added support for new Wasm runtimes: slight, spin, and wasmtime. Users can download Wasm runtimes on demand when the containerd image store is enabled.
- Added Rust server support to Docker init.
- Beta release of the Builds view that lets you inspect builds and manage builders. This can be found in the Features in Development tab in Settings.
Upgrades#
- Buildx v0.11.0
- Compose v2.19.0
- Kubernetes v1.27.2
- cri-tools v1.27.0
- cri-dockerd v0.3.2
- coredns v1.10.1
- cni v1.2.0
- etcd v3.5.7
Bug fixes and enhancements#
For all platforms#
- Docker Desktop now automatically pauses the Docker Engine when it is not in use and wakes up again on demand.
- VirtioFS is now the default file sharing implementation for new installations of Docker Desktop on macOS 12.5 and higher.
- Improved product usage reporting using OpenTelemetry (experimental).
- Fixed Docker socket permissions. Fixes docker/for-win#13447 and docker/for-mac#6823.
- Fixed an issue which caused Docker Desktop to hang when quitting the application whilst paused.
- Fixed a bug which caused the Logs and Terminal tab content in the Container view to be covered by a fixed toolbar docker/for-mac#6814.
- Fixed a bug which caused input labels to overlap with input values on the container run dialog. Fixes docker/for-win#13304.
- Fixed a bug which meant users couldn't select the Docker Extension menu. Fixes docker/for-mac#6840 and docker/for-mac#6855
For Mac#
- Added a health check for macOS that notifies users if there has been a change on their system which might cause problems running Docker binaries.
For Windows#
- Fixed a bug on WSL 2 where if Desktop is paused, killed, and then restarted, the startup hangs unless WSL is shut down first with
wsl --shutdown
. - Fixed the WSL engine in cases where wsl.exe is not on the PATH docker/for-win#13547.
- Fixed the WSL engine's ability to detect cases where one of the Docker Desktop distros' drive is missing docker/for-win#13554.
- A slow or unresponsive WSL integration no longer prevents Docker Desktop from starting. Fixes docker/for-win#13549.
- Fixed a bug that caused Docker Desktop to crash on startup docker/for-win#6890.
- Added the following installer flags:
--hyper-v-default-data-root
which specifies the default location for Hyper-V VM disk.--windows-containers-default-data-root
which specifies the default data root for Windows Containers.--wsl-default-data-root
which specifies the default location for WSL distro disks.
4.20.1#
{ { < release-date date="2023-06-05" > } }
Bug fixes and enhancements#
For all platforms#
- containerd image store: Fixed a bug that caused
docker load
to fail when loading an image that contains attestations. - containerd image store: Fixed the default image exporter during build.
For Windows#
- Fixed a bug that made it difficult to parse the WSL version on the host in non-western locales. Fixes docker/for-win#13518 and docker/for-win#13524.
4.20.0#
{ { < release-date date="2023-05-30" > } }
Upgrades#
Bug fixes and enhancements#
For all platforms#
- Docker Scout CLI now finds the most recently built image if it is not provided as an argument.
- Improved the Docker Scout CLI
compare
command. - Added a warning about the retirement of Docker Compose ECS/ACS integrations in November 2023. Can be suppressed with
COMPOSE_CLOUD_EOL_SILENT=1
. - Fixed an HTTP proxy bug where an HTTP 1.0 client could receive an HTTP 1.1 response.
- Enabled Docker Desktop's Enhanced Container Isolation (ECI) feature on WSL-2. This is available with a Docker Business subscription.
- Fixed a bug on the Containers table where previously hidden columns were displayed again after a fresh installation of Docker Desktop.
For Mac#
- You can now reclaim disk space more quickly when files are deleted in containers. Related to docker/for-mac#371.
- Fixed a bug that prevented containers accessing 169.254.0.0/16 IPs. Fixes docker/for-mac#6825.
- Fixed a bug in
com.docker.diagnose check
where it would complain about a missing vpnkit even when vpnkit is not expected to be running. Related to docker/for-mac#6825.
For Windows#
- Fixed a bug that meant WSL data could not be moved to a different disk. Fixes docker/for-win#13269.
- Fixed a bug where Docker Desktop was not stopping its WSL distros (docker-desktop and docker-desktop-data) when it was shutdown, consuming host memory unnecessarily.
- Added a new setting that allows the Windows Docker daemon to use Docker Desktop's internal proxy when running Windows containers. See Windows proxy settings.
For Linux#
- Fixed an issue with the Docker Compose V1/V2 compatibility setting.
4.19.0#
{ { < release-date date="2023-04-27" > } }
New#
- Docker Engine and CLI updated to Moby 23.0.
- The Learning Center now supports in-product walkthroughs.
- Docker init (Beta) now supports Node.js and Python.
- Faster networking between VM and host on macOS.
- You can now inspect and analyze remote images from Docker Desktop without pulling them.
- Usability and performance improvements to the Artifactory images view.
Removed#
- Removed
docker scan
command. To continue learning about the vulnerabilities of your images, and many other features, use the newdocker scout
command. Rundocker scout --help
, or read the docs to learn more.
Upgrades#
Bug fixes and enhancements#
For all platforms#
- Improved
docker scout compare
command to compare two images, now also aliased underdocker scout diff
. - Added more details to dashboard errors when a
docker-compose
action fails (docker/for-win#13378). - Added support for setting HTTP proxy configuration during installation. This can be done via the
--proxy-http-mode
,--overrider-proxy-http
,--override-proxy-https
and--override-proxy-exclude
installer flags in the case of installation from the CLI on Mac and Windows, or alternatively by setting the values in theinstall-settings.json
file. - Docker Desktop now stops overriding .docker/config.json
credsStore
keys on application start. Note that if you use a custom credential helper then the CLIdocker login
anddocker logout
does not affect whether the UI is signed in to Docker or not. In general, it is better to sign into Docker via the UI since the UI supports multi-factor authentication. - Added a warning about the forthcoming removal of Compose V1 from Docker Desktop. Can be suppressed with
COMPOSE_V1_EOL_SILENT=1
. - In the Compose config, boolean fields in YAML should be either
true
orfalse
. Deprecated YAML 1.1 values such as “on” or “no” now produce a warning. - Improved UI for image table, allowing rows to use more available space.
- Fixed various bugs in port-forwarding.
- Fixed a HTTP proxy bug where an HTTP request without a Server Name Indication record would be rejected with an error.
For Windows#
- Reverted to fully patching etc/hosts on Windows (includes
host.docker.internal
andgateway.docker.internal
again). For WSL, this behavior is controlled by a new setting in the General tab. Fixes docker/for-win#13388 and docker/for-win#13398. - Fixed a spurious
courgette.log
file appearing on the Desktop when updating Docker Desktop. Fixes docker/for-win#12468. - Fixed the "zoom in" shortcut (ctrl+=). Fixes docker/for-win#13392.
- Fixed a bug where the tray menu would not correctly update after second container type switch. Fixes docker/for-win#13379.
For Mac#
- Increased the performance of VM networking when using the Virtualization framework on macOS Ventura and above. Docker Desktop for Mac now uses gVisor instead of VPNKit. To continue using VPNKit, add
"networkType":"vpnkit"
to yoursettings.json
file located at~/Library/Group Containers/group.com.docker/settings.json
. - Fixed a bug where an error window is displayed on uninstall.
- Fixed a bug where the setting
deprecatedCgroupv1
was ignored. Fixes docker/for-mac#6801. - Fixed cases where
docker pull
would returnEOF
.
For Linux#
- Fixed a bug where the VM networking crashes after 24h. Fixes docker/desktop-linux#131.
Security#
For all platforms#
- Fixed a security issue allowing users to bypass Image Access Management (IAM) restrictions configured by their organisation by avoiding
registry.json
enforced login via deleting thecredsStore
key from their Docker CLI configuration file. Only affects Docker Business customers. - Fixed CVE-2023-24532.
- Fixed CVE-2023-25809.
- Fixed CVE-2023-27561.
- Fixed CVE-2023-28642.
- Fixed CVE-2023-28840.
- Fixed CVE-2023-28841.
- Fixed CVE-2023-28842.
4.18.0#
{ { < release-date date="2023-04-03" > } }
New#
- Initial beta release of
docker init
as per the roadmap. - Added a new Learning Center tab to help users get started with Docker.
- Added an experimental file-watch command to Docker Compose that automatically updates your running Compose services as you edit and save your code.
Upgrades#
- Buildx v0.10.4
- Compose 2.17.2
- Containerd v1.6.18, which includes fixes for CVE-2023-25153 and CVE-2023-25173.
- Docker Engine v20.10.24, which contains fixes for CVE-2023-28841, CVE-2023-28840, and CVE-2023-28842.
Bug fixes and enhancements#
For all platforms#
- Docker Scout CLI can now compare two images and display packages and vulnerabilities differences. This command is in Early Access and might change in the future.
- Docker Scout CLI now displays base image update and remediation recommendations using
docker scout recommendations
. It also displays a short overview of an image usingdocker scout quickview
commands. - You can now search for extensions direct from the Marketplace, as well as using Global Search.
- Fixed a bug where
docker buildx
container builders would lose access to the network after 24hrs. - Reduced how often users are prompted for feedback on Docker Desktop.
- Removed minimum VM swap size.
- Added support for subdomain match, CIDR match,
.
and_.
in HTTP proxy exclude lists. - Fixed a bug in the transparent TLS proxy when the Server Name Indication field is not set.
- Fixed a grammatical error in Docker Desktop engine status message.
For Windows#
- Fixed a bug where
docker run --gpus=all
hangs. Fixes docker/for-win#13324. - Fixed a bug where Registry Access Management policy updates were not downloaded.
- Docker Desktop now allows Windows containers to work when BitLocker is enabled on
C:
. - Docker Desktop with the WSL backend no longer requires the
com.docker.service
privileged service to run permanently. For more information see Permission requirements for Windows.
For Mac#
- Fixed a performance issue where attributes stored on the host would not be cached for VirtioFS users.
- The first time Docker Desktop for Mac is launched, the user is presented with an installation window to confirm or adjust the configuration that requires privileged access. For more information see Permission requirements for Mac.
- Added the Advanced tab in Settings, where users can adjust the settings which require privileged access.
For Linux#
- Fixed a bug where the VM networking crashes after 24h. docker/for-linux#131
Security#
For all platforms#
- Fixed CVE-2023-1802 where a security issue with the Artifactory Integration would cause it to fall back to sending registry credentials over plain HTTP if HTTPS check failed. Only users who have
Access experimental features
enabled are affected. Fixes docker/for-win#13344.
For Mac#
- Removed the
com.apple.security.cs.allow-dyld-environment-variables
andcom.apple.security.cs.disable-library-validation
entitlements which allow an arbitrary dynamic library to be loaded with Docker Desktop via theDYLD_INSERT_LIBRARIES
environment variable.
Known Issues#
- Uninstalling Docker Desktop on Mac from the Troubleshoot page might trigger an unexpected fatal error popup.
4.17.1#
{ { < release-date date="2023-03-20" > } }
Bug fixes and enhancements#
For Windows#
- Docker Desktop now allows Windows containers to work when BitLocker is enabled on C:
- Fixed a bug where
docker buildx
container builders would lose access to the network after 24hrs. - Fixed a bug where Registry Access Management policy updates were not downloaded.
- Improved debug information to better characterise failures under WSL 2.
Known Issues#
- Running containers with
--gpus
on Windows with the WSL 2 backend does not work. This will be fixed in future releases. See docker/for-win/13324.
4.17.0#
{ { < release-date date="2023-02-27" > } }
New#
- Docker Desktop now ships with Docker Scout. Pull and view analysis for images from Docker Hub and Artifactory repositories, get base image updates and recommended tags and digests, and filter your images on vulnerability information. To learn more, see Docker Scout.
docker scan
has been replaced bydocker scout
. See Docker Scout CLI, for more information.- You can now discover extensions that have been autonomously published in the Extensions Marketplace. For more information on self-published extensions, see Marketplace Extensions.
- Container File Explorer is available as an experimental feature. Debug the filesystem within your containers straight from the GUI.
- You can now search for volumes in Global Search.
Upgrades#
- Containerd v1.6.18, which includes fixes for CVE-2023-25153 and CVE-2023-25173.
- Docker Engine v20.10.23.
- Go 1.19.5
Bug fixes and enhancements#
For all platforms#
- Fixed a bug where diagnostic gathering could hang waiting for a subprocess to exit.
- Prevented the transparent HTTP proxy from mangling requests too much. Fixes Tailscale extension login, see tailscale/docker-extension#49.
- Fixed a bug in the transparent TLS proxy where the Server Name Indication field is not set.
- Added support for subdomain match, CIDR match,
.
and*.
in HTTP proxy exclude lists. - Ensured HTTP proxy settings are respected when uploading diagnostics.
- Fixed fatal error when fetching credentials from the credential helper.
- Fixed fatal error related to concurrent logging.
- Improved the UI for Extension actions in the Marketplace.
- Added new filters in the Extensions Marketplace. You can now filter extensions by category and reviewed status.
- Added a way to report a malicious extension to Docker.
- Updated Dev Environments to v0.2.2 with initial set up reliability & security fixes.
- Added a whalecome survey for new users only.
- The confirmation dialogs on the troubleshooting page are now consistent in style with other similar dialogs.
- Fixed fatal error caused by resetting the Kubernetes cluster before it has started.
- Implemented
docker import
for the containerd integration. - Fixed image tagging with an existing tag with the containerd integration.
- Implemented the dangling filter on images for the containerd integration.
- Fixed
docker ps
failing with containers whose images are no longer present with the containerd integration.
For Mac#
- Fixed download of Registry Access Management policy on systems where the privileged helper tool
com.docker.vmnetd
is not installed. - Fixed a bug where
com.docker.vmnetd
could not be installed if/Library/PrivilegedHelperTools
does not exist. - Fixed a bug where the "system" proxy would not handle "autoproxy" / "pac file" configurations.
- Fixed a bug where vmnetd installation fails to read
Info.Plist
on case-sensitive file systems. The actual filename isInfo.plist
. Fixes docker/for-mac#6677. - Fixed a bug where user is prompted to create the docker socket symlink on every startup. Fixes docker/for-mac#6634.
- Fixed a bug that caused the Start Docker Desktop when you log in setting not to work. Fixes docker/for-mac#6723.
- Fixed UDP connection tracking and
host.docker.internal
. Fixes docker/for-mac#6699. - Improved kubectl symlink logic to respect existing binaries in
/usr/local/bin
. Fixes docker/for-mac#6328. - Docker Desktop now automatically installs Rosetta when you opt-in to use it but have not already installed it.
For Windows#
- Added statical linking of WSL integration tools against
musl
so there is no need to installalpine-pkg-glibc
in user distros. - Added support for running under cgroupv2 on WSL 2. This is activated by adding
kernelCommandLine = systemd.unified_cgroup_hierarchy=1 cgroup_no_v1=all
to your%USERPROFILE%\.wslconfig
file in the[wsl2]
section. - Fixed an issue that caused Docker Desktop to get stuck in the "starting" phase when in WSL 2 mode (introduced in 4.16).
- Fixed Docker Desktop failing to start the WSL 2 backend when file system compression or encryption is enabled on
%LOCALAPPDATA%
. - Fixed Docker Desktop failing to report a missing or outdated (incapable of running WSL version 2 distros) WSL installation when starting.
- Fixed a bug where opening in Visual Studio Code fails if the target path has a space.
- Fixed a bug that causes
~/.docker/context
corruption and the error message "unexpected end of JSON input". You can also remove~/.docker/context
to work around this problem. - Ensured the credential helper used in WSL 2 is properly signed. Related to docker/for-win#10247.
- Fixed an issue that caused WSL integration agents to be terminated erroneously. Related to docker/for-win#13202.
- Fixed corrupt contexts on start. Fixes docker/for-win#13180 and docker/for-win#12561.
For Linux#
- Added Docker Buildx plugin for Docker Desktop for Linux.
- Changed compression algorithm to
xz
for RPM and Arch Linux distribution. - Fixed a bug that caused leftover files to be left in the root directory of the Debian package. Fixes docker/for-linux#123.
Security#
For all platforms#
- Fixed CVE-2023-0628, which allows an attacker to execute an arbitrary command inside a Dev Environments container during initialization by tricking a user to open a crafted malicious
docker-desktop://
URL. - Fixed CVE-2023-0629, which allows an unprivileged user to bypass Enhanced Container Isolation (ECI) restrictions by setting the Docker host to
docker.raw.sock
, ornpipe:////.pipe/docker_engine_linux
on Windows, via the-H
(--host
) CLI flag or theDOCKER_HOST
environment variable and launch containers without the additional hardening features provided by ECI. This does not affect already running containers, nor containers launched through the usual approach (without Docker's raw socket).
4.16.3#
{ { < release-date date="2023-01-30" > } }
Bug fixes and enhancements#
For Windows#
- Fixed Docker Desktop failing to start the WSL 2 backend when file system compression or encryption is enabled on
%LOCALAPPDATA%
. Fixes docker/for-win#13184. - Fixed Docker Desktop failing to report a missing or outdated WSL installation when starting. Fixes docker/for-win#13184.
4.16.2#
{ { < release-date date="2023-01-19" > } }
Bug fixes and enhancements#
For all platforms#
- Fixed an issue where
docker build
anddocker tag
commands produced animage already exists
error if the containerd integration feature is enabled. - Fixed a regression introduced with Docker Desktop 4.16 breaking networking from containers with target platform linux/386 on amd64 systems. Fixes docker/for-mac/6689.
For Mac#
- Fixed the capitalization of
Info.plist
which causedvmnetd
to break on case-sensitive file systems. Fixes docker/for-mac/6677.
For Windows#
- Fixed a regression introduced with Docker Desktop 4.16 causing it to get stuck in the "starting" phase when in WSL2 mode. Fixes docker/for-win/13165
4.16.1#
{ { < release-date date="2023-01-13" > } }
Bug fixes and enhancements#
For all platforms#
- Fixed
sudo
inside a container failing with a security related error for some images. Fixes docker/for-mac/6675 and docker/for-win/13161.
4.16.0#
{ { < release-date date="2023-01-12" > } }
New#
- Extensions have moved from Beta to GA.
- Quick Search has moved from experimental to GA.
- Extensions are now included in Quick Search.
- Analyzing large images is now up to 4x faster.
- New local images view has moved from experimental to GA.
- New Beta feature for MacOS 13, Rosetta for Linux, has been added for faster emulation of Intel-based images on Apple Silicon.
Upgrades#
- Compose v2.15.1
- Containerd v1.6.14
- Docker Engine v20.10.22
- Buildx v0.10.0
- Docker Scan v0.23.0
- Go 1.19.4
Bug fixes and enhancements#
For all platforms#
- Fixed
docker build --quiet
not outputting the image identifier with thecontainerd
integration. - Fixed image inspect not showing image labels with the
containerd
integration. - Increased the contrast between running and stopped container icons to make it easier for colorblind people to scan the containers list.
- Fixed a bug where the user is prompted for new HTTP proxy credentials repeatedly until Docker Desktop is restarted.
- Added a diagnostics command
com.docker.diagnose login
to check HTTP proxy configuration. - Fixed actions on compose stack not working properly. Fixes docker/for-mac#6566.
- Fixed the Docker dashboard trying at startup to get disk usage information and display an error banner before the engine was running.
- Added an informational banner with instructions on how to opt-out of experimental feature access next to all experimental features.
- Docker Desktop now supports downloading Kubernetes images via an HTTP proxy.
- Fixed tooltips to not block action buttons. Fixes docker/for-mac#6516.
- Fixed the blank "An error occurred" container list on the Container view.
For Mac#
- Minimum OS version to install or update Docker Desktop on macOS is now macOS Big Sur (version 11) or later.
- Fixed the Docker engine not starting when Enhanced Container Isolation is enabled if the legacy
osxfs
implementation is used for file sharing. - Fixed files created on VirtioFS having the executable bit set. Fixes docker/for-mac#6614.
- Added back a way to uninstall Docker Desktop from the command line. Fixes docker/for-mac#6598.
- Fixed hardcoded
/usr/bin/kill
. Fixes docker/for-mac#6589. - Fixed truncation (for example with the
truncate
command) of very large files (> 38GB) shared on VirtioFS with an incorrect size. - Changed the disk image size in Settings to use the decimal system (base 10) to coincide with how Finder displays disk capacity.
- Fixed Docker crash under network load. Fixes docker/for-mac#6530.
- Fixed an issue causing Docker to prompt the user to install the
/var/run/docker.sock
symlink after every reboot. - Ensured the Login Item which installs the
/var/run/docker.sock
symlink is signed. - Fixed bug where
$HOME/.docker
was removed on factory reset.
For Windows#
- Fixed
docker build
hanging while printing "load metadata for". Fixes docker/for-win#10247. - Fixed typo in diagnose.exe output Fixes docker/for-win#13107.
- Added support for running under cgroupv2 on WSL 2. This is activated by adding
kernelCommandLine = systemd.unified_cgroup_hierarchy=1 cgroup_no_v1=all
to your%USERPROFILE%\.wslconfig
file in the[wsl2]
section.
Known Issues#
- Calling
sudo
inside a container fails with a security related error for some images. See docker/for-mac/6675 and docker/for-win/13161.
4.15.0#
{ { < release-date date="2022-12-01" > } }
New#
- Substantial performance improvements for macOS users with the option of enabling the new VirtioFS file sharing technology. Available for macOS 12.5 and above.
- Docker Desktop for Mac no longer needs to install the privileged helper process
com.docker.vmnetd
on install or on the first run. For more information see Permission requirements for Mac. - Added WebAssembly capabilities. Use with the containerd integration.
- Improved the descriptions for beta and experimental settings to clearly explain the differences and how people can access them.
- Available disk space of VM now displays in the footer of Docker Dashboard for Mac and Linux.
- A disk space warning now displays in the footer if available space is below 3GB.
- Changes to Docker Desktop's interface as we become more ADA accessible and visually unified.
- Added a Build tab inside Extensions which contains all the necessary resources to build an extension.
- Added the ability to share extensions more easily, either with
docker extension share
CLI or with the share button in the extensions Manage tab. - Extensions in the Marketplace now display the number of installs. You can also sort extensions by the number of installs.
- Dev Environments allow cloning a Git repository to a local bind mount, so you can use any local editor or IDE.
- More Dev Environments improvements: custom names, better private repo support, improved port handling.
Upgrades#
Bug fixes and enhancements#
For all platforms#
- Containers are now restored on restart with the containerd integration.
- Fixed listing multi-platform images with the containerd integration.
- Better handling of dangling images with the containerd integration.
- Implement "reference" filter for images with the containerd integration.
- Added support for selecting upstream HTTP/HTTPS proxies automatically via
proxy.pac
in containers,docker pull
etc. - Fixed regressions when parsing image references on pull. Fixes docker/for-win#13053, docker/for-mac#6560, and docker/for-mac#6540.
For Mac#
- Improved the performance of
docker pull
.
For Windows#
- Fixed an issue where the system HTTP proxies were not used when Docker starts and the developer logs in.
- When Docker Desktop is using "system" proxies and if the Windows settings change, Docker Desktop now uses the new Windows settings without a restart.
For Linux#
- Fixed hot-reload issue on Linux. Fixes docker/desktop-linux#30.
- Disabled tray icon animations on Linux which fixes crashes for some users.
4.14.1#
{ { < release-date date="2022-11-17" > } }
Bug fixes and enhancements#
For all platforms#
- Fixed container DNS lookups when using Registry Access Management.
For Mac#
- Fixed an issue preventing the Analyze Image button on the Images tab from working.
- Fixed a bug causing symlinks to not be created for the user if
/usr/local/lib
doesn't already exist. Fixes docker/for-mac#6569
4.14.0#
{ { < release-date date="2022-11-10" > } }
New#
- Set Virtualization framework as the default hypervisor for macOS >= 12.5.
- Migrate previous install to Virtualization framework hypervisor for macOS >= 12.5.
- The Enhanced Container Isolation feature, available to Docker Business users, can now be enabled from the General Settings.
Updates#
- Docker Engine v20.10.21,
which contains mitigations against a Git vulnerability, tracked in CVE-2022-39253,
and updates the handling of
image:tag@digest
image references. - Docker Compose v2.12.2
- Containerd v1.6.9
- Go 1.19.3
Bug fixes and enhancements#
For all platforms#
- Docker Desktop now requires an internal network subnet of size /24. If you were previously using a /28, it is automatically expanded to /24. If you experience networking issues, check to see if you have a clash between the Docker subnet and your infrastructure. Fixes docker/for-win#13025.
- Fixed an issue that prevents users from creating Dev Environments when the Git URL has upper-case characters.
- Fix the
vpnkit.exe is not running
error reported in diagnostics. - Reverted qemu to 6.2.0 to fix errors like
PR_SET_CHILD_SUBREAPER is unavailable
when running emulated amd64 code. - Enabled contextIsolation and sandbox mode inside Extensions. Now Extensions run in a separate context and this limits the harm that malicious code can cause by limiting access to most system resources.
- Included
unpigz
to allow parallel decompression of pulled images. - Fixed issues related to performing actions on selected containers. Fixes https://github.com/docker/for-win/issues/13005
- Added functionality that allows you to display timestamps for your container or project view.
- Fixed a possible segfault when interrupting
docker pull
with Control+C. - Increased the default DHCP lease time to avoid the VM's network glitching and dropping connections every two hours.
- Removed the infinite spinner on the containers list. Fixes https://github.com/docker/for-mac/issues/6486
- Fixed bug which showed incorrect values on used space in Settings.
- Fixed a bug that caused Kubernetes not to start with the containerd integration.
- Fixed a bug that caused
kind
not to start with the containerd integration. - Fixed a bug that caused Dev Environments to not work with the containerd integration.
- Implemented
docker diff
in the containerd integration. - Implemented
docker run —-platform
in the containerd integration. - Fixed a bug that caused insecure registries not to work with the containerd integration.
For Mac#
- Fixed a startup failure for users of Virtualization framework.
- Re-added the
/var/run/docker.sock
on Mac by default, to increase compatibility with tooling liketilt
anddocker-py.
- Fixed an issue that prevented the creation of Dev Environments on new Mac installs (error "Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?").
For Windows#
- Re-added
DockerCli.exe -SharedDrives
. Fixes docker/for-win#5625. - Docker Desktop now allows Docker to function on machines where PowerShell is disabled.
- Fixed an issue where Compose v2 was not always enabled by default on Windows.
- Docker Desktop now deletes the
C:\Program Files\Docker
folder at uninstall.
Known Issues#
- For some users on Mac OS there is a known issue with the installer that prevents the installation of a new helper tool needed for the experimental vulnerability and package discovery feature in Docker Desktop. To fix this, a symlink is needed that can be created with the following command:
sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker-index /usr/local/bin/docker-index
4.13.1#
{ { < release-date date="2022-10-31" > } }
Updates#
Bug fixes and enhancements#
For all platforms#
- Fixed a possible segfault when interrupting
docker pull
withControl+C
orCMD+C
. - Increased the default DHCP lease time to avoid the VM's network glitching and dropping connections every two hours.
- Reverted
Qemu
to6.2.0
to fix errors likePR_SET_CHILD_SUBREAPER is unavailable
when running emulated amd64 code.
For Mac#
- Added back the
/var/run/docker.sock
symlink on Mac by default, to increase compatibility with tooling liketilt
anddocker-py
. Fixes docker/for-mac#6529. - Fixed an issue preventing the creation of Dev Environments on new Mac installs and causing
error "Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?")
For Windows#
- Docker Desktop now functions on machines where PowerShell is disabled.
4.13.0#
{ { < release-date date="2022-10-19" > } }
New#
- Two new security features have been introduced for Docker Business users, Settings Management and Enhanced Container Isolation. Read more about Docker Desktop’s new Hardened Docker Desktop security model.
- Added the new Dev Environments CLI
docker dev
, so you can create, list, and run Dev Envs via command line. Now it's easier to integrate Dev Envs into custom scripts. - Docker Desktop can now be installed to any drive and folder using the
--installation-dir
. Partially addresses docker/roadmap#94.
Updates#
- Docker Scan v0.21.0
- Go 1.19.2 to address CVE-2022-2879, CVE-2022-2880 and CVE-2022-41715
- Updated Docker Engine and Docker CLI to v20.10.20,
which contain mitigations against a Git vulnerability, tracked in CVE-2022-39253,
and updated handling of
image:tag@digest
image references, as well as a fix for CVE-2022-36109. - Docker Credential Helpers v0.7.0
- Docker Compose v2.12.0
- Kubernetes v1.25.2
- Qemu 7.0.0 used for cpu emulation, inside the Docker Desktop VM.
- Linux kernel 5.15.49
Bug fixes and enhancements#
For all platforms#
- Docker Desktop now allows the use of TLS when talking to HTTP and HTTPS proxies to encrypt proxy usernames and passwords.
- Docker Desktop now stores HTTP and HTTPS proxy passwords in the OS credential store.
- If Docker Desktop detects that the HTTP or HTTPS proxy password has changed then it will prompt developers for the new password.
- The Bypass proxy settings for these hosts and domains setting now handles domain names correctly for HTTPS.
- The Remote Repositories view and Tip of the Day now works with HTTP and HTTPS proxies which require authentication
- We’ve introduced dark launch for features that are in early stages of the product development lifecycle. Users that are opted in can opt out at any time in the settings under the “beta features” section.
- Added categories to the Extensions Marketplace.
- Added an indicator in the whale menu and on the Extension tab on when extension updates are available.
- Fixed failing uninstalls of extensions with image names that do not have a namespace, as in 'my-extension'.
- Show port mapping explicitly in the Container tab.
- Changed the refresh rate for disk usage information for images to happen automatically once a day.
- Made the tab style consistent for the Container and Volume tabs.
- Fixed Grpcfuse filesharing mode enablement in Settings. Fixes docker/for-mac#6467
- Virtualization Framework and VirtioFS are disabled for users running macOS < 12.5.
- Ports on the Containers tab are now clickable.
- The Extensions SDK now allows
ddClient.extension.vm.cli.exec
,ddClient.extension.host.cli.exec
,ddClient.docker.cli.exec
to accept a different working directory and pass environment variables through the options parameters. - Added a small improvement to navigate to the Extensions Marketplace when clicking on Extensions in the sidebar.
- Added a badge to identify new extensions in the Marketplace.
- Fixed kubernetes not starting with the containerd integration.
- Fixed
kind
not starting with the containerd integration. - Fixed dev environments not working with the containerd integration.
- Implemented
docker diff
in the containerd integration. - Implemented
docker run —-platform
in the containerd integration. - Fixed insecure registries not working with the containerd integration.
- Fixed a bug that showed incorrect values on used space in Settings.
- Docker Desktop now installs credential helpers from Github releases. See docker/for-win#10247, docker/for-win#12995.
- Fixed an issue where users were logged out of Docker Desktop after 7 days.
For Mac#
- Added Hide, Hide others, Show all menu items for Docker Desktop. See docker/for-mac#6446.
- Fixed a bug which caused the application to be deleted when running the install utility from the installed application. Fixes docker/for-mac#6442.
- By default Docker will not create the /var/run/docker.sock symlink on the host and use the docker-desktop CLI context instead.
For Linux#
- Fixed a bug that prevented pushing images from the Dashboard
4.12.0#
{ { < release-date date="2022-09-01" > } }
New#
- Added the ability to use containerd for pulling and storing images. This is an experimental feature.
- Docker Desktop now runs untagged images. Fixes docker/for-mac#6425.
- Added search capabilities to Docker Extension's Marketplace. Fixes docker/roadmap#346.
- Added the ability to zoom in, out or set Docker Desktop to Actual Size. This is done by using keyboard shortcuts ⌘ + / CTRL +, ⌘ - / CTRL -, ⌘ 0 / CTRL 0 on Mac and Windows respectively, or through the View menu on Mac.
- Added compose stop button if any related container is stoppable.
- Individual compose containers are now deletable from the Container view.
- Removed the workaround for virtiofsd <-> qemu protocol mismatch on Fedora 35, as it is no longer needed. Fedora 35 users should upgrade the qemu package to the most recent version (qemu-6.1.0-15.fc35 as of the time of writing).
- Implemented an integrated terminal for containers.
- Added a tooltip to display the link address for all external links by default.
Updates#
- Docker Compose v2.10.2
- Docker Scan v0.19.0
- Kubernetes v1.25.0
- Go 1.19
- cri-dockerd v0.2.5
- Buildx v0.9.1
- containerd v1.6.8
- containerd v1.6.7
- runc v1.1.4
- runc v1.1.3
Security#
For all platforms#
- Fixed CVE-2023-0626 which allows RCE via query parameters in the message-box route in the Electron client.
- Fixed CVE-2023-0625 which allows RCE via extension description/changelog which could be abused by a malicious extension.
For Windows#
- Fixed CVE-2023-0627 which allows to bypass for the
--no-windows-containers
installation flag which was introduced in version 4.11. This flag allows administrators to disable the use of Windows containers. - Fixed CVE-2023-0633 in which an argument injection to the Docker Desktop installer which may result in local privilege escalation.
Bug fixes and minor enhancements#
For all platforms#
- Compose V2 is now enabled after factory reset.
- Compose V2 is now enabled by default on new installations of Docker Desktop.
- Precedence order of environment variables in Compose is more consistent, and clearly documented.
- Upgraded kernel to 5.10.124.
- Improved overall performance issues caused by calculating disk size. Related to docker/for-win#9401.
- Docker Desktop now prevents users on ARM macs without Rosetta installed from switching back to Compose V1, which has only intel binaries.
- Changed the default sort order to descending for volume size and the Created column, along with the container's Started column.
- Re-organized container row actions by keeping only the start/stop and delete actions visible at all times, while allowing access to the rest via the row menu item.
- The Quickstart guide now runs every command immediately.
- Defined the sort order for container/compose Status column to running > some running > paused > some paused > exited > some exited > created.
- Fixed issues with the image list appearing empty in Docker Desktop even though there are images. Related to docker/for-win#12693 and docker/for-mac#6347.
- Defined what images are "in use" based on whether or not system containers are displayed. If system containers related to Kubernetes and Extensions are not displayed, the related images are not defined as "in use."
- Fixed a bug that made Docker clients in some languages hang on
docker exec
. Fixes https://github.com/apocas/dockerode/issues/534. - A failed spawned command when building an extension no longer causes Docker Desktop to unexpectedly quit.
- Fixed a bug that caused extensions to be displayed as disabled in the left menu when they are not.
- Fixed
docker login
to private registries when Registry Access Management is enabled and access to Docker Hub is blocked. - Fixed a bug where Docker Desktop fails to start the Kubernetes cluster if the current cluster metadata is not stored in the
.kube/config
file. - Updated the tooltips in Docker Desktop and MUI theme package to align with the overall system design.
- Copied terminal contents do not contain non-breaking spaces anymore.
For Mac#
- Minimum version to install or update Docker Desktop on macOS is now 10.15. Fixes docker/for-mac#6007.
- Fixed a bug where the Tray menu incorrectly displays "Download will start soon..." after downloading the update. Fixes some issue reported in for-mac/issues#5677
- Fixed a bug that didn't restart Docker Desktop after applying an update.
- Fixed a bug that caused the connection to Docker to be lost when the computer sleeps if a user is using virtualization.framework and restrictive firewall software.
- Fixed a bug that caused Docker Desktop to run in the background even after a user had quit the application. Fixes docker/for-mac##6440
- Disabled both Virtualization Framework and VirtioFS for users running macOS < 12.5
For Windows#
- Fixed a bug where versions displayed during an update could be incorrect. Fixes for-win/issues#12822.
4.11.1#
{ { < release-date date="2022-08-05" > } }
Bug fixes and enhancements#
For all platforms#
- Fixed regression preventing VM system locations (e.g. /var/lib/docker) from being bind mounted for-mac/issues#6433
For Windows#
- Fixed
docker login
to private registries from WSL2 distro docker/for-win#12871
4.11.0#
{ { < release-date date="2022-07-28" > } }
New#
- Docker Desktop is now fully supported for Docker Business customers inside VMware ESXi and Azure VMs. For more information, see Run Docker Desktop inside a VM or VDI environment
- Added two new extensions (vcluster and PGAdmin4) to the Extensions Marketplace.
- The ability to sort extensions has been added to the Extensions Marketplace.
- Fixed a bug that caused some users to be asked for feedback too frequently. You'll now only be asked for feedback twice a year.
- Added custom theme settings for Docker Desktop. This allows you to specify dark or light mode for Docker Desktop independent of your device settings. Fixes docker/for-win#12747
- Added a new flag for Windows installer.
--no-windows-containers
disables the Windows containers integration. - Added a new flag for Mac install command.
--user <username>
sets up Docker Desktop for a specific user, preventing them from needing an admin password on first run.
Updates#
Bug fixes and enhancements#
For all platforms#
- Added the Container / Compose icon as well as the exposed port(s) / exit code to the Containers screen.
- Updated the Docker theme palette colour values to match our design system.
- Improved an error message from
docker login
if Registry Access Management is blocking the Docker engine's access to Docker Hub. - Increased throughput between the Host and Docker. For example increasing performance of
docker cp
. - Collecting diagnostics takes less time to complete.
- Selecting or deselecting a compose app on the containers overview now selects/deselects all its containers.
- Tag names on the container overview image column are visible.
- Added search decorations to the terminal's scrollbar so that matches outside the viewport are visible.
- Fixed an issue with search which doesn't work well on containers page docker/for-win#12828.
- Fixed an issue which caused infinite loading on the Volume screen docker/for-win#12789.
- Fixed a problem in the Container UI where resizing or hiding columns didn't work. Fixes docker/for-mac#6391.
- Fixed a bug where the state of installing, updating, or uninstalling multiple extensions at once was lost when leaving the Marketplace screen.
- Fixed an issue where the compose version in the about page would only get updated from v2 to v1 after restarting Docker Desktop.
- Fixed an issue where users cannot see the log view because their underlying hardware didn't support WebGL2 rendering. Fixes docker/for-win#12825.
- Fixed a bug where the UI for Containers and Images got out of sync.
- Fixed a startup race when the experimental virtualization framework is enabled.
For Mac#
- Fixed an issue executing Compose commands from the UI. Fixes docker/for-mac#6400.
For Windows#
- Fixed horizontal resizing issue. Fixes docker/for-win#12816.
- If an HTTP/HTTPS proxy is configured in the UI, then it automatically sends traffic from image builds and running containers to the proxy. This avoids the need to separately configure environment variables in each container or build.
- Added the
--backend=windows
installer option to set Windows containers as the default backend.
For Linux#
- Fixed bug related to setting up file shares with spaces in their path.
4.10.1#
{ { < release-date date="2022-07-05" > } }
Bug fixes and enhancements#
For Windows#
- Fixed a bug where actions in the UI failed with Compose apps that were created from WSL. Fixes docker/for-win#12806.
For Mac#
- Fixed a bug where the install command failed because paths were not initialized. Fixes docker/for-mac#6384.
4.10.0#
{ { < release-date date="2022-06-30" > } }
New#
- You can now add environment variables before running an image in Docker Desktop.
- Added features to make it easier to work with a container's logs, such as regular expression search and the ability to clear container logs while the container is still running.
- Implemented feedback on the containers table. Added ports and separated container and image names.
- Added two new extensions, Ddosify and Lacework, to the Extensions Marketplace.
Removed#
- Removed Homepage while working on a new design. You can provide feedback here.
Updates#
- Docker Engine v20.10.17
- Docker Compose v2.6.1
- Kubernetes v1.24.1
- cri-dockerd to v0.2.1
- CNI plugins to v1.1.1
- containerd to v1.6.6
- runc to v1.1.2
- Go 1.18.3
Bug fixes and enhancements#
For all platforms#
- Added additional bulk actions for starting/pausing/stopping selected containers in the Containers tab.
- Added pause and restart actions for compose projects in the Containers tab.
- Added icons and exposed ports or exit code information in the Containers tab.
- External URLs can now refer to extension details in the Extension Marketplace using links such as
docker-desktop://extensions/marketplace?extensionId=docker/logs-explorer-extension
. - The expanded or collapsed state of the Compose apps is now persisted.
docker extension
CLI commands are available with Docker Desktop by default.- Increased the size of the screenshots displayed in the Extension marketplace.
- Fixed a bug where a Docker extension fails to load if its backend container(s) are stopped. Fixes docker/extensions-sdk#16.
- Fixed a bug where the image search field is cleared without a reason. Fixes docker/for-win#12738.
- Fixed a bug where the license agreement does not display and silently blocks Docker Desktop startup.
- Fixed the displayed image and tag for unpublished extensions to actually display the ones from the installed unpublished extension.
- Fixed the duplicate footer on the Support screen.
- Dev Environments can be created from a subdirectory in a GitHub repository.
- Removed the error message if the tips of the day cannot be loaded when using Docker Desktop offline. Fixes docker/for-mac#6366.
For Mac#
- Fixed a bug with location of bash completion files on macOS. Fixes docker/for-mac#6343.
- Fixed a bug where Docker Desktop does not start if the username is longer than 25 characters. Fixes docker/for-mac#6122.
- Fixed a bug where Docker Desktop was not starting due to invalid system proxy configuration. Fixes some issues reported in docker/for-mac#6289.
- Fixed a bug where Docker Desktop failed to start when the experimental virtualization framework is enabled.
- Fixed a bug where the tray icon still displayed after uninstalling Docker Desktop.
For Windows#
- Fixed a bug which caused high CPU usage on Hyper-V. Fixes docker/for-win#12780.
- Fixed a bug where Docker Desktop for Windows would fail to start. Fixes docker/for-win#12784.
- Fixed the
--backend=wsl-2
installer flag which did not set the backend to WSL 2. Fixes docker/for-win#12746.
For Linux#
- Fixed a bug when settings cannot be applied more than once.
- Fixed Compose version displayed in the
About
screen.
Known Issues#
- Occasionally the Docker engine will restart during a
docker system prune
. This is a known issue in the version of buildkit used in the current engine and will be fixed in future releases.
4.9.1#
{ { < release-date date="2022-06-16" > } }
{ { < desktop-install all=true version="4.9.1" build_path="/81317/" > } }
Bug fixes and enhancements#
For all platforms#
- Fixed blank dashboard screen. Fixes docker/for-win#12759.
4.9.0#
{ { < release-date date="2022-06-02" > } }
New#
- Added additional guides on the homepage for: Elasticsearch, MariaDB, Memcached, MySQL, RabbitMQ and Ubuntu.
- Added a footer to the Docker Dashboard with general information about the Docker Desktop update status and Docker Engine statistics
- Re-designed the containers table, adding:
- A button to copy a container ID to the clipboard
- A pause button for each container
- Column resizing for the containers table
- Persistence of sorting and resizing for the containers table
- Bulk deletion for the containers table
Updates#
Bug fixes and enhancements#
For all platforms#
- Fixed an issue which caused Docker Desktop to hang if you quit the app whilst Docker Desktop was paused.
- Fixed the Kubernetes cluster not resetting properly after the PKI expires.
- Fixed an issue where the Extensions Marketplace was not using the defined http proxies.
- Improved the logs search functionality in Docker Dashboard to allow spaces.
- Middle-button mouse clicks on buttons in the Dashboard now behave as a left-button click instead of opening a blank window.
For Mac#
- Fixed an issue to avoid creating
/opt/containerd/bin
and/opt/containerd/lib
on the host if/opt
has been added to the file sharing directories list.
For Windows#
- Fixed a bug in the WSL 2 integration where if a file or directory is bind-mounted to a container, and the container exits, then the file or directory is replaced with the other type of object with the same name. For example, if a file is replaced with a directory or a directory with a file, any attempts to bind-mount the new object fails.
- Fixed a bug where the Tray icon and Dashboard UI didn't show up and Docker Desktop didn't fully start. Fixes docker/for-win#12622.
Known issues#
For Linux#
- Changing ownership rights for files in bind mounts fails. This is due to the way we have implemented file sharing between the host and VM within which the Docker Engine runs. We aim to resolve this issue in the next release.
4.8.2#
{ { < release-date date="2022-05-18" > } }
Updates#
Bug fixes and minor enahancements#
- Fixed an issue with manual proxy settings which caused problems when pulling images. Fixes docker/for-win#12714 and docker/for-mac#6315.
- Fixed high CPU usage when extensions are disabled. Fixes docker/for-mac#6310.
- Docker Desktop now redacts HTTP proxy passwords in log files and diagnostics.
Known issues#
For Linux#
- Changing ownership rights for files in bind mounts fails. This is due to the way we have implemented file sharing between the host and VM within which the Docker Engine runs. We aim to resolve this issue in the next release.
4.8.1#
{ { < release-date date="2022-05-09" > } }
New#
- Released Docker Desktop for Linux.
- Beta release of Docker Extensions and Extensions SDK.
- Created a Docker Homepage where you can run popular images and discover how to use them.
- Compose V2 is now GA
Bug fixes and enhancements#
- Fixed a bug that caused the Kubernetes cluster to be deleted when updating Docker Desktop.
Known issues#
For Linux#
- Changing ownership rights for files in bind mounts fails. This is due to the way we have implemented file sharing between the host and VM within which the Docker Engine runs. We aim to resolve this issue in the next release.
4.8.0#
{ { < release-date date="2022-05-06" > } }
New#
- Released Docker Desktop for Linux.
- Beta release of Docker Extensions and Extensions SDK.
- Created a Docker Homepage where you can run popular images and discover how to use them.
- Compose V2 is now GA
Updates#
Bug fixes and minor enhancements#
For all platforms#
- Introduced reading system proxy. You no longer need to manually configure proxies unless it differs from your OS level proxy.
- Fixed a bug that showed Remote Repositories in the Dashboard when running behind a proxy.
- Fixed vpnkit establishing and blocking the client connection even if the server is gone. See docker/for-mac#6235
- Made improvements on the Volume tab in Docker Desktop:
- Volume size is displayed.
- Columns can be resized, hidden and reordered.
- A columns sort order and hidden state is persisted, even after Docker Desktop restarts.
- Row selection is persisted when switching between tabs, even after Docker Desktop restarts.
- Fixed a bug in the Dev Environments tab that did not add a scroll when more items were added to the screen.
- Standardised the header title and action in the Dashboard.
- Added support for downloading Registry Access Management policies through HTTP proxies.
- Fixed an issue related to empty remote repositories when the machine is in sleep mode for an extended period of time.
- Fixed a bug where dangling images were not selected in the cleanup process if their name was not marked as "<none>" but their tag is.
- Improved the error message when
docker pull
fails because an HTTP proxy is required. - Added the ability to clear the search bar easily in Docker Desktop.
- Renamed the "Containers / Apps" tab to "Containers".
- Fixed a silent crash in the Docker Desktop installer when
C:\ProgramData\DockerDesktop
is a file or a symlink. - Fixed a bug where an image with no namespace, for example
docker pull <private registry>/image
, would be erroneously blocked by Registry Access Management unless access to Docker Hub was enabled in settings.
For Mac#
- Docker Desktop's icon now matches Big Sur Style guide. See docker/for-mac#5536
- Fixed a problem with duplicate Dock icons and Dock icon not working as expected. Fixes docker/for-mac#6189.
- Improved support for the
Cmd+Q
shortcut.
For Windows#
- Improved support for the
Ctrl+W
shortcut.
Known issues#
For all platforms#
- Currently, if you are running a Kubernetes cluster, it will be deleted when you upgrade to Docker Desktop 4.8.0. We aim to fix this in the next release.
For Linux#
- Changing ownership rights for files in bind mounts fails. This is due to the way we have implemented file sharing between the host and VM within which the Docker Engine runs. We aim to resolve this issue in the next release.
4.7.1#
{ { < release-date date="2022-04-19" > } }
Bug fixes and enhancements#
For all platforms#
- Fixed a crash on the Quick Start Guide final screen.
For Windows#
- Fixed a bug where update was failing with a symlink error. Fixes docker/for-win#12650.
- Fixed a bug that prevented using Windows container mode. Fixes docker/for-win#12652.
4.7.0#
{ { < release-date date="2022-04-07" > } }
New#
- IT Administrators can now install Docker Desktop remotely using the command line.
- Add the Docker Software Bill of Materials (SBOM) CLI plugin. The new CLI plugin enables users to generate SBOMs for Docker images.
- Use cri-dockerd for new Kubernetes clusters instead of
dockershim
. The change is transparent from the user's point of view and Kubernetes containers run on the Docker Engine as before.cri-dockerd
allows Kubernetes to manage Docker containers using the standard Container Runtime Interface, the same interface used to control other container runtimes. For more information, see The Future of Dockershim is cri-dockerd.
Updates#
Security#
- Update Docker Engine to v20.10.14 to address CVE-2022-24769
- Update containerd to v1.5.11 to address CVE-2022-24769
Bug fixes and enahncements#
For all platforms#
- Fixed a bug where the Registry Access Management policy was never refreshed after a failure.
- Logs and terminals in the UI now respect your OS theme in light and dark mode.
- Easily clean up many volumes at once via multi-select checkboxes.
- Improved login feedback.
For Mac#
- Fixed an issue that sometimes caused Docker Desktop to display a blank white screen. Fixes docker/for-mac#6134.
- Fixed a problem where gettimeofday() performance drops after waking from sleep when using Hyperkit. Fixes docker/for-mac#3455.
- Fixed an issue that caused Docker Desktop to become unresponsive during startup when
osxfs
is used for file sharing.
For Windows#
- Fixed volume title. Fixes docker/for-win#12616.
- Fixed a bug in the WSL 2 integration that caused Docker commands to stop working after restarting Docker Desktop or after switching to Windows containers.
4.6.1#
{ { < release-date date="2022-03-22" > } }
Updates#
Bug fixes and enahncements#
- Prevented spinning in vpnkit-forwarder filling the logs with error messages.
- Fixed diagnostics upload when there is no HTTP proxy set. Fixes docker/for-mac#6234.
- Removed a false positive "vm is not running" error from self-diagnose. Fixes docker/for-mac#6233.
4.6.0#
{ { < release-date date="2022-03-14" > } }
New#
For all platforms#
- The Docker Dashboard Volume Management feature now offers the ability to efficiently clean up volumes using multi-select checkboxes.
For Mac#
- Docker Desktop 4.6.0 gives macOS users the option of enabling a new experimental file sharing technology called VirtioFS. During testing VirtioFS has been shown to drastically reduce the time taken to sync changes between the host and VM, leading to substantial performance improvements. For more information, see VirtioFS.
Updates#
For all platforms#
- Docker Engine v20.10.13
- Compose v2.3.3
- Buildx 0.8.0
- containerd v1.4.13
- runc v1.0.3
- Go 1.17.8
- Linux kernel 5.10.104
Security#
For all platforms#
- Fixed CVE-2022-0847, aka “Dirty Pipe”, an issue that could enable attackers to modify files in container images on the host, from inside a container.
If using the WSL 2 backend, you must update WSL 2 by running
wsl --update
.
For Windows#
- Fixed CVE-2022-26659, which could allow an attacker to overwrite any administrator writable file on the system during the installation or the update of Docker Desktop.
For Mac#
Bug fixes and enhancements#
For all platforms#
- Fixed uploading diagnostics when an HTTPS proxy is set.
- Made checking for updates from the systray menu open the Software updates settings section.
For Mac#
- Fixed the systray menu not displaying all menu items after starting Docker Desktop. Fixes docker/for-mac#6192.
- Fixed a regression about Docker Desktop not starting in background anymore. Fixes docker/for-mac#6167.
- Fixed missing Docker Desktop Dock icon. Fixes docker/for-mac#6173.
- Used speed up block device access when using the experimental
virtualization.framework
. See benchmarks. - Increased default VM memory allocation to half of physical memory (min 2 GB, max 8 GB) for better out-of-the-box performances.
For Windows#
- Fixed the UI stuck in
starting
state forever although Docker Desktop is working fine from the command line. - Fixed missing Docker Desktop systray icon docker/for-win#12573
- Fixed Registry Access Management under WSL 2 with latest 5.10.60.1 kernel.
- Fixed a UI crash when selecting the containers of a Compose application started from a WSL 2 environment. Fixes docker/for-win#12567.
- Fixed copying text from terminal in Quick Start Guide. Fixes docker/for-win#12444.
Known issues#
For Mac#
- After enabling VirtioFS, containers with processes running with different Unix user IDs may experience caching issues. For example if a process running as
root
queries a file and another process running as usernginx
tries to access the same file immediately, thenginx
process will get a "Permission Denied" error.
4.5.1#
{ { < release-date date="2022-02-15" > } }
Bug fixes and enhancements#
For Windows#
- Fixed an issue that caused new installations to default to the Hyper-V backend instead of WSL 2.
- Fixed a crash in the Docker Dashboard which would make the systray menu disappear.
If you are running Docker Desktop on Windows Home, installing 4.5.1 will switch it back to WSL 2 automatically. If you are running another version of Windows, and you want Docker Desktop to use the WSL 2 backend, you must manually switch by enabling the Use the WSL 2 based engine option in the Settings > General section.
Alternatively, you can edit the Docker Desktop settings file located at %APPDATA%\Docker\settings.json
and manually switch the value of the wslEngineEnabled
field to true
.
4.5.0#
{ { < release-date date="2022-02-10" > } }
New#
- Docker Desktop 4.5.0 introduces a new version of the Docker menu which creates a consistent user experience across all operating systems. For more information, see the blog post New Docker Menu & Improved Release Highlights with Docker Desktop 4.5
- The 'docker version' output now displays the version of Docker Desktop installed on the machine.
Updates#
Security#
For Mac#
- Fixed CVE-2021-44719 where Docker Desktop could be used to access any user file on the host from a container, bypassing the allowed list of shared folders.
For Windows#
- Fixed CVE-2022-23774 where Docker Desktop allows attackers to move arbitrary files.
Bug fixes and enhancements#
For all platforms#
- Fixed an issue where Docker Desktop incorrectly prompted users to sign in after they quit Docker Desktop and start the application.
- Increased the filesystem watch (inotify) limits by setting
fs.inotify.max_user_watches=1048576
andfs.inotify.max_user_instances=8192
in Linux. Fixes docker/for-mac#6071.
For Mac#
- Fixed an issue that caused the VM to become unresponsive during startup when using
osxfs
and when no host directories are shared with the VM. - Fixed an issue that didn't allow users to stop a Docker Compose application using Docker Dashboard if the application was started in a different version of Docker Compose. For example, if the user started a Docker Compose application in V1 and then switched to Docker Compose V2, attempts to stop the Docker Compose application would fail.
- Fixed an issue where Docker Desktop incorrectly prompted users to sign in after they quit Docker Desktop and start the application.
- Fixed an issue where the About Docker Desktop window wasn't working anymore.
- Limit the number of CPUs to 8 on Mac M1 to fix the startup problem. Fixes docker/for-mac#6063.
For Windows#
- Fixed an issue related to compose app started with version 2, but the dashboard only deals with version 1
Known issues#
For Windows#
Installing Docker Desktop 4.5.0 from scratch has a bug which defaults Docker Desktop to use the Hyper-V backend instead of WSL 2. This means, Windows Home users will not be able to start Docker Desktop as WSL 2 is the only supported backend. To work around this issue, you must uninstall 4.5.0 from your machine and then download and install Docker Desktop 4.5.1 or a higher version. Alternatively, you can edit the Docker Desktop settings.json file located at %APPDATA%\Docker\settings.json
and manually switch the value of the wslEngineEnabled
field to true
.
4.4.4#
{ { < release-date date="2022-01-24" > } }
Bug fixes and enhancements#
For Windows#
- Fixed logging in from WSL 2. Fixes docker/for-win#12500.
Known issues#
For Windows#
- Clicking Proceed to Desktop after signing in through the browser, sometimes does not bring the Dashboard to the front.
- After logging in, when the Dashboard receives focus, it sometimes stays in the foreground even when clicking a background window. As a workaround you need to click the Dashboard before clicking another application window.
- The tips of the week show on top of the mandatory login dialog when an organization restriction is enabled via a
registry.json
file.
4.4.3#
{ { < release-date date="2022-01-14" > } }
Bug fixes and enhancements#
For Windows#
- Disabled Dashboard shortcuts to prevent capturing them even when minimized or un-focussed. Fixes docker/for-win#12495.
Known issues#
For Windows#
- Clicking Proceed to Desktop after signing in through the browser, sometimes does not bring the Dashboard to the front.
- After logging in, when the Dashboard receives focus, it sometimes stays in the foreground even when clicking a background window. As a workaround you need to click the Dashboard before clicking another application window.
- The tips of the week show on top of the mandatory login dialog when an organization restriction is enabled via a
registry.json
file.
4.4.2#
{ { < release-date date="22-01-13" > } }
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#
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.
Bug fixes and enhancements#
For all platforms#
- Docker Desktop displays an error if
registry.json
contains more than one organization in theallowedOrgs
field. If you are using multiple organizations for different groups of developers, you must provision a separateregistry.json
file for each group. - Fixed a regression in Compose that reverted the container name separator from
-
to_
. Fixes docker/compose-switch.
For Mac#
- Fixed the memory statistics for containers in the Dashboard. Fixes docker/for-mac/#4774.
- Added a deprecated option to
settings.json
:"deprecatedCgroupv1": true
, which switches the Linux environment back to cgroups v1. If your software requires cgroups v1, you should update it to be compatible with cgroups v2. Although cgroups v1 should continue to work, it is likely that some future features will depend on cgroups v2. It is also possible that some Linux kernel bugs will only be fixed with cgroups v2. - 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.
For Windows#
- Doing a
Reset to factory defaults
no longer shuts down Docker Desktop.
Known issues#
For all platforms#
- The tips of the week show on top of the mandatory login dialog when an organization restriction is enabled via a
registry.json
file.
For Windows#
- Clicking Proceed to Desktop after logging in in the browser, sometimes does not bring the Dashboard to the front.
- After logging in, when the Dashboard receives focus, it sometimes stays in the foreground even when clicking a background window. As a workaround you need to click the Dashboard before clicking another application window.
- When the Dashboard is open, even if it does not have focus or is minimized, it will still catch keyboard shortcuts (e.g. ctrl-r for Restart)
4.3.2#
{ { < release-date date="2021-12-21" > } }
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#
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.
4.3.1#
{ { < release-date date="2021-12-11" > } }
Upgrades#
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.
4.3.0#
{ { < release-date date="2021-12-02" > } }
Upgrades#
- Docker Engine v20.10.11
- containerd v1.4.12
- Buildx 0.7.1
- Compose v2.2.1
- Kubernetes 1.22.4
- Docker Hub Tool v0.4.4
- Go 1.17.3
Bug fixes and minor changes#
For all platforms#
- Added a self-diagnose warning if the host lacks Internet connectivity.
- 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.
- Docker Desktop now uses cgroupv2. If you need to run
systemd
in a container then: - Ensure your version of
systemd
supports cgroupv2. It must be at leastsystemd
247. Consider upgrading anycentos:7
images tocentos:8
. - Containers running
systemd
need the following options:--privileged --cgroupns=host -v /sys/fs/cgroup:/sys/fs/cgroup:rw
.
For Mac#
- Docker Desktop on Apple silicon no longer requires Rosetta 2, with the exception of three optional command line tools.
For Windows#
- Fixed an issue that caused Docker Desktop to fail during startup if the home directory path contains a character used in regular expressions. Fixes docker/for-win#12374.
Known issue#
Docker Dashboard incorrectly displays the container memory usage as zero on
Hyper-V based machines.
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 usehost.docker.internal
,vm.docker.internal
, andgateway.docker.internal
. - Removed: Custom RBAC rules have been removed from Docker Desktop as it gives
cluster-admin
privileges to all Service Accounts. Fixes docker/for-mac/#4774.
4.2.0#
{ { < release-date date="2021-11-09" > } }
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.
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.
Window management: The Docker Dashboard window size and position persists when you close and reopen Docker Desktop.
Upgrades#
Bug fixes and minor changes#
For all platforms#
- 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.
For Mac#
- 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 addedDENY DELETE
ACL entries on the corresponding host directory. - Fixed a bug where a
Docker.qcow2
file would be ignored on upgrade and a freshDocker.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 oldDocker.qcow2
, delete the newerDocker.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.
For Windows#
- Fixed Docker Desktop sometimes hanging when clicking Exit in the fatal error dialog.
- Fixed an issue that frequently displayed the Download update popup when an update has been downloaded but hasn't been applied yet docker/for-win#12188.
- Fixed installing a new update killing the application before it has time to shut down.
- Fixed: Installation of Docker Desktop now works even with group policies preventing users to start prerequisite services (e.g. LanmanServer) docker/for-win#12291.
4.1.1#
{ { < release-date date="2021-10-12" > } }
Bug fixes and minor changes#
For Mac#
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 freshDocker.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 oldDocker.qcow2
, delete the newerDocker.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.
For Windows#
- Fixed a regression in WSL 2 integrations for some distros (e.g. Arch or Alpine). Fixes docker/for-win#12229
- Fixed update notification overlay sometimes getting out of sync between the Settings button and the Software update button in the Dashboard.
4.1.0#
{ { < release-date date="2021-09-30" > } }
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.
- 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. Ships Docker Public Roadmap#215
Upgrades#
- Compose V2
- Buildx 0.6.3
- Kubernetes 1.21.5
- Go 1.17.1
- Alpine 3.14
- Qemu 6.1.0
- Base distro to debian:bullseye
Bug fixes and minor changes#
For Windows#
- Fixed a bug related to anti-malware software triggering, self-diagnose avoids calling the
net.exe
utility. - Fixed filesystem corruption in the WSL 2 Linux VM in self-diagnose. This can be caused by microsoft/WSL#5895.
- Fixed
SeSecurityPrivilege
requirement issue. See docker/for-win#12037. - Fixed CLI context switch sync with UI. See docker/for-win#11721.
- Added the key
vpnKitMaxPortIdleTime
tosettings.json
to allow the idle network connection timeout to be disabled or extended. - Fixed a crash on exit. See docker/for-win#12128.
- Fixed a bug where the CLI tools would not be available in WSL 2 distros.
- Fixed switching from Linux to Windows containers that was stuck because access rights on panic.log. See for-win#11899.
Known Issues#
For Windows#
Docker Desktop may fail to start when upgrading to 4.1.0 on some WSL-based distributions such as ArchWSL. See docker/for-win#12229
4.0.1#
{ { < release-date date="2021-09-13" > } }
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#
For all platforms#
- Fixed a bug where copy-paste was not available in the Docker Dashboard.
For Windows#
- Fixed a bug where Docker Desktop would not start correctly with the Hyper-V engine. See docker/for-win#11963
4.0.0#
{ { < release-date date="2021-08-31" > } }
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#
- Compose V2 RC2
- Fixed project name to be case-insensitive for
compose down
. See docker/compose-cli#2023 - Fixed non-normalized project name.
- Fixed port merging on partial reference.
- Kubernetes 1.21.4
Bug fixes and minor changes#
For Mac#
- Fixed a bug where SSH was not available for builds from git URL. Fixes for-mac#5902
For Windows#
- Fixed a bug where the CLI tools would not be available in WSL 2 distros.
- Fixed a bug when switching from Linux to Windows containers due to access rights on
panic.log
. for-win#11899