# Docker Desktop release notes This page contains information about the new features, improvements, known issues, and bug fixes in Docker Desktop releases. Releases are gradually rolled out to ensure quality control. If the latest version is not yet available to you, allow some time — updates typically become available within a week of the release date. Docker Desktop versions older than 6 months from the latest release are not available for download. Previous release notes are available in our [documentation repository](https://github.com/docker/docs/tree/main/content/manuals/desktop/previous-versions). For more frequently asked questions, see the [FAQs](/desktop/troubleshoot-and-support/faqs/releases/). ## 4.94.0 2026-10-05 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/241994/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/241994/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/241994/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/241994/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/241994/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/241994/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/241994/docker-desktop-x86_64.pkg.tar.zst) ### Update - Docker Offload `v0.6.53` - [containerd v2.3.6](https://github.com/containerd/containerd/releases/tag/v2.3.6) - [Docker Agent v1.144.0](https://github.com/docker/docker-agent/releases/tag/v1.144.0) - [NVIDIA Container Toolkit v1.20.1](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.20.1) - [Docker Scout CLI v1.25.0](https://github.com/docker/scout-cli/releases/tag/v1.25.0) - [Docker Engine v29.8.2](https://docs.docker.com/engine/release-notes/29/#2982) - [Docker Buildx v0.37.2](https://github.com/docker/buildx/releases/tag/v0.37.2) ### Bug fixes and enhancements #### For all platforms - Fixed an issue where Resource Saver could pause the VM before the Docker API was ready, causing transient errors during engine startup or restart. - Fixed `kubectl logs` not working with `kubeadm`. - Fixed the Docker Desktop service being left stopped after an update when it was running but not configured to auto-start. - Fixed stored API keys being written in clear to Docker Desktop logs and included in diagnostics bundles. - Fixed the account name and tier briefly showing as empty and personal after a restart when Docker Hub was slow to respond. - Changed the default logging driver for new Linux containers to `local` to enable automatic log rotation and reduce disk usage. - Fixed an issue in the **Images** view where the reclaimable disk space value could get stuck at **0 Bytes** while selecting images for deletion. - Improved VM disk creation speed and reduced host disk space usage by skipping unnecessary inode table zeroing on sparse and pre-zeroed storage. - Fixed Docker Desktop writing a multi-gigabyte error file and consuming excessive memory when the backend failed to start. - Docker Desktop now names the settings file that needs correcting instead of reporting an unexpected error when it contains invalid JSON. - Stopped Docker Desktop logs from recording unobfuscated values for IPC payloads that are JSON arrays or plain strings. - Fixed a deadlock that caused Docker Desktop to hang indefinitely when quitting while an engine recovery or error dialog was displayed. - Fixed the kindest/node tag showing blank in `docker desktop kubernetes images`. - docker-pass: - Removing a secret that does not exist is now consistent with other `docker remove` commands. - Running the examples from the help text no longer prefixes the secret with a line break. - Fixed long Ask Gordon conversations where the end of responses was hidden behind the user's message, and where scrolling up jumped around or got stuck. #### For Mac - Fixed the update tooltip suggesting to move Docker Desktop to `/Applications` when that is the folder the current user cannot modify. Fixes [docker/desktop-feedback#598](https://github.com/docker/desktop-feedback/issues/598). - Fixed repeated privileged-access prompts when Docker Desktop starts automatically after a reboot. Fixes [docker/desktop-feedback#651](https://github.com/docker/desktop-feedback/issues/651). - Fixed the "CLI tools installation" setting on macOS reverting to System when Docker Desktop could not update the login shell profile. - Fixed zsh completions not being set up when `~/.zshrc` doesn't exist. #### For Windows - Improved WSL startup errors to explain when virtualization is disabled in firmware, nested virtualization is unavailable, or the Windows hypervisor is disabled at startup, with guidance for resolving each condition. - Fixed the Docker Desktop service losing its automatic start mode after an update run by WinGet or another external installer when the service had been installed with `--always-run-service`. - Fixed a bug introduced in 4.92.0 where WSL integration could fail to start with "timed out waiting for ... to be automounted". Fixes [docker/desktop-feedback#695](https://github.com/docker/desktop-feedback/issues/695). #### For Linux - Fixed a bug on Linux where quitting Docker Desktop could close unrelated applications, including all open terminal windows. Fixes [docker/desktop-linux#109](https://github.com/docker/desktop-linux/issues/109). ## 4.93.0 2026-09-28 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/240920/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/240920/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/240920/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/240920/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/240920/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/240920/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/240920/docker-desktop-x86_64.pkg.tar.zst) ### Updates - Docker Offload `v0.6.33` - [Docker Agent v1.141.0](https://github.com/docker/docker-agent/releases/tag/v1.141.0) - [Docker Engine v29.8.1](https://docs.docker.com/engine/release-notes/29/#2981) - Linux kernel `v7.0.14` ### Bug fixes and enhancements #### For all platforms - CLI plugin updates are now managed directly from the app bundle and the **Automatically update components** setting has been removed. - Fixed Enhanced Container Isolation not being enforced on an engine that was left running while another one was in use. - Fixed Enhanced Container Isolation not being enforced when an administrator policy arrived after the engine had started. Fixed Enhanced Container Isolation not being enforced when the sign-in completed after the engine had started. - Fixed file sharing directories (and other list settings) reverting to their default after clearing them and restarting Docker Desktop. Fixes [docker/desktop-feedback#515](https://github.com/docker/desktop-feedback/issues/515). - Fixed a security vulnerability that allowed VM-side code to request Unix socket port forwards, which could expose arbitrary host paths to manipulation. - Fixed an issue where dismissing the walkthroughs lead-in on the **Containers** or **Images** screen was not reliably preserved across sessions. - Fixed a silent failure when Docker Desktop cannot open an external URL by showing an error notification, and fixed ephemeral error notifications incorrectly appearing as unread in the notification bell. - Fixed an issue where Docker Desktop continued showing Kubernetes as running after a cloud cluster stopped externally. - Fixed cluster reconnect failures in Kubernetes Offload mode and updated the cluster creation dialog to show only relevant kind cluster options when in Offload mode. - Fixed Docker Desktop failing to start with an unexpected error when the engine needed more than five minutes to recover after an unclean shutdown. - Updated the Linux kernel to 7.0.14, fixing MongoDB 8 containers refusing to start. Fixes [docker/desktop-feedback#682]. #### For Mac - Fixed the command-line installer removing the privileged `vmnetd` helper when run without `--user`. - Fixed a bug that could make Docker Desktop updates fail repeatedly when a leftover staging directory from a previous update couldn't be deleted. - Added a clear error message when macOS denies Docker Desktop the virtualization entitlement, for example due to an MDM configuration profile. - Fixed an issue where the Repair function showed no explanation when CLI plugins failed to be correctly set up. - Docker Desktop no longer overwrites a more recent CLI plugin installed under `~/.docker/cli-plugins`, matching existing Windows behavior. - Fixed "previous version restored" after a failed update even when the restore itself failed. #### For Windows - Fixed an issue where MSI installs never added the installing user to the `docker-users` group, requiring manual group membership configuration. - Fixed an issue on Windows where update failures showed a generic error message instead of the actual installer error details. - Fixed a bug where a failed read of a WSL distro's `config.json` caused the distro agent to crash, disabled WSL integration, and prevented factory reset from cleaning up `~/.docker` properly. - Fixed an issue where the Docker CLI credential store in a WSL2 distro could be unexpectedly reset to the default on restart. - Fixed an unhelpful error message when WSL timed out registering the Docker Desktop Linux distribution. - Fixed spurious "WSL integration with distro unexpectedly stopped" dialogs when the Docker Desktop engine was being stopped or restarted. - Fixed a false "Virtualization support not detected" error when starting the WSL2 backend on Windows systems with Virtual Machine Platform enabled but the vfpext service absent. - Fixed a startup crash (exit code 151) on Windows when config files such as `settings-store.json` or `daemon.json` were saved with a UTF-8 BOM by an external editor or provisioning tool. - Fixed a WSL integration issue where the proxy could fatally timeout at startup when restoring persisted bind mounts, especially with non-default `wsl.conf` automount root configurations. #### For Linux - Docker Desktop no longer overwrites a more recent CLI plugin installed under `~/.docker/cli-plugins`, matching existing Windows behavior. ## 4.92.0 2026-09-21 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/240144/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/240144/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/240144/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/240144/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/240144/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/240144/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/240144/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [containerd v2.3.5](https://github.com/containerd/containerd/releases/tag/v2.3.5) - [Docker Agent v1.140.0](https://github.com/docker/docker-agent/releases/tag/v1.140.0) - [Docker Buildx v0.37.1](https://github.com/docker/buildx/releases/tag/v0.37.1) - Docker Offload `v0.6.27` ### Bug fixes and enhancements #### For all platforms - Fixed published ports staying unreachable for the life of the container when the host port was momentarily busy. - Fixed in-app updates repeatedly failing when the update manifest contains no installer matching the current installation. - Fixed Kubernetes staying on "Starting Kubernetes" indefinitely when the cluster failed to initialize. The error is now reported. - Fixed **Send Diagnostics** hanging indefinitely, or showing an unhelpful error, when a proxy blocks the upload. - Fixed container start, stop, and restart failures in the Docker Desktop Dashboard reporting only a generic HTTP error instead of the reason reported by Docker Engine. - Fixed Docker Hub repository and tag browsing to use Docker Hub's current API, and removed the non-functional **Starred** and **Contributed** tabs from Docker Hub organization profiles. - Fixed an issue where users signed out before a Docker Desktop update were not prompted to sign in after the app restarted. - Fixed **Settings** section navigation to scroll to the selected section reliably, and added a divider between sections for easier visual parsing. - Improved Kubernetes cloud cluster management by hiding the `kubeadm` option in the cluster dialog and resetting the cluster mode to kind when the dialog closes. - Improved Ask Gordon so sessions start in the relevant project directory when launched from a volume or build history row, and added a banner that prompts you to select a project folder when chatting from an auto-generated scratch directory. - Fixed Ask Gordon file diffs: edits that share a near-identical text prefix, the summary bar overlapping your message when scrolling, and row backgrounds and column width in the edit tool-call view. - Fixed Ask Gordon chat: a blank command in the shell approval dialog, background job tool calls rendering as raw JSON, streamed command output jank, raw internal error details, and opening Ask Gordon from **Settings**, **Troubleshoot**, or **Support** corrupting drawer state for Ask Gordon, notifications, and the Learning Center. #### For Mac - Fixed moving the disk image to another location being slow on macOS 26. - Fixed a macOS update failure where validating the staged app could fail even though the app was valid, and extended that validation to catch a staged app that fails to start. - Fixed excessive idle CPU usage on Retina displays caused by a badge animation in the Ask Gordon interface. #### For Windows - Added support for migrating admin, per-machine installations to per-user installations when running the Docker VMM backend, in addition to WSL 2. - Fixed an issue where Windows 10 users with the inbox `wsl.exe` saw a raw error instead of the prompt to update WSL when Docker Desktop checked the WSL version. - Fixed `host.docker.internal` and `gateway.docker.internal` not being injected into Windows containers after Docker Desktop lost the container event stream. - The MSI installer now refuses per-user installations, which are not supported, instead of installing a copy that later updates cannot upgrade. - Fixed a misleading error message that claimed the WSL disk image had been deleted when WSL could not open it while registering the Docker Desktop distribution. - Fixed Kubernetes failing to start after a WSL distro that had been integrated was unregistered. - Fixed single-file bind mounts on Docker VMM. The "not shared from the host" error now points at the file's containing directory, and a file entry in the **File sharing** settings no longer prevents the engine from starting. - Fixed Docker Desktop retrying the WSL engine indefinitely without reporting an error when WSL was unable to load its own kernel modules. - Fixed disk image location moves always failing when moving to a different drive. Fixes [docker/desktop-feedback#548](https://github.com/docker/desktop-feedback/issues/548) and [docker/desktop-feedback#550](https://github.com/docker/desktop-feedback/issues/550). - Fixed a failed incremental update not retrying with a full installer. - Fixed the WSL 2 cross-distro bind-mount proxy serving stale or incomplete directory contents for host paths on slow-to-mount drives, such as Storage Pool volumes. ### Security - Updated containerd to `v2.3.5`, addressing [CVE-2026-53495](https://github.com/advisories/GHSA-7jxh-36q5-gcqv). ### Known issues - WSL integration can fail to start with `timed out waiting for ... to be automounted` when a distro's `wsl.conf` sets `[automount] root` to `/`, or after a container has bind-mounted a non-drive path under `/mnt`, such as WSLg's `/mnt/wslg`. As a workaround, downgrade to Docker Desktop 4.91.0, or remove the `root` setting from `wsl.conf` and run `wsl --shutdown`. ## 4.91.0 2026-09-14 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/239619/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/239619/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/239619/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/239619/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/239619/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/239619/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/239619/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Engine v29.8.0](https://docs.docker.com/engine/release-notes/29/#2980) - [containerd v2.3.4](https://github.com/containerd/containerd/releases/tag/v2.3.4) - [Docker Compose v5.5.1](https://github.com/docker/compose/releases/tag/v5.5.1) - [Docker Agent v1.136.0](https://github.com/docker/docker-agent/releases/tag/v1.131.0) - Docker Desktop Build `v0.38.0` - [Docker Buildx v0.37.0](https://github.com/docker/buildx/releases/tag/v0.37.0) - Docker Offload `v0.6.17` - [Credential helpers v0.9.9](https://github.com/docker/docker-credential-helpers/releases/tag/v0.9.9) ### Bug fixes and enhancements #### For all platforms - Fixed an issue where the **Last modified** column in the Volumes and container filesystem browsers displayed inaccurate timestamps like '57 years ago' instead of a blank when modification time was unavailable. - Fixed Docker Desktop writing invalid export PATH syntax into csh/tcsh profiles when adding `~/.docker/bin` to PATH. - Fixed an issue where Docker Scout CLI hints would persist after upgrading. - Fixed a bug where a corrupt Docker network database, usually caused by an abrupt shutdown, prevented Docker Engine from starting and left a factory reset as the only recovery option. - Fixed CLI plugin updates failing repeatedly when the plugin binary was locked by another process. The update is now retried automatically on the next start. - Fixed Docker Desktop's interface getting stuck in an indefinite restart loop on machines with certain graphics driver issues, and added a message explaining when the interface can't be displayed due to a hardware compatibility problem. - Improved startup experience in the new UI by showing a themed skeleton layout (header, sidebar, footer) immediately instead of a blank window while the app loads. - Fixed Docker Desktop sometimes taking five extra minutes to report the engine as stopped when the virtual machine stopped unexpectedly. - Fix Kubernetes (kubeadm) missing CNI loopback interface name. - Fixed MCP profile tours getting stuck or rendering tooltips off-screen. - Fixed a bug where changing the disk image location to a different volume could delete the existing disk image if the operation was interrupted before the copy started. - Fixed Docker Compose rebuilding locally-built images on every Resource Saver wake. Fixes [docker/desktop-feedback#507](https://github.com/docker/desktop-feedback/issues/507). - Fixed a regression where Hub image search and tag listing would break if the Docker Hub API response included unexpected or changed fields. - Fixed an issue where the VM could be unexpectedly shut down when the idle timeout was set to 0. #### For Mac - Fixed Docker Desktop adding `~/.docker/bin` to the login-shell PATH even when CLI tools were installed to the system path, which could create a `~/.bash_profile` that hid the user's existing shell environment. - Added `kubectl` shell completions. Fixes [docker/for-mac](https://github.com/docker/for-mac/issues/7205) #### For Windows - Fixed a bug where switching to Windows containers with the WSL engine still enabled could incorrectly offer to continue without starting the required privileged service. - Fixed an issue where uninstalling Docker Desktop left a stale `FeaturesRequireReboot=1` registry key, which could cause unexpected reboot prompts on subsequent installs. - Fixed Docker Desktop staying on "Starting..." indefinitely when WSL could not access the disk image location, and reported the access failure with actionable guidance instead of a generic WSL error. - Fixed the Windows MSI installer reporting success even when the Docker Desktop service failed to install or start. - Fixed a spurious failure when running a command right after switching to Windows containers. ## 4.90.0 2026-09-07 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/238679/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/238679/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/238679/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/238679/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/238679/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/238679/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/238679/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Agent v1.128.0](https://github.com/docker/docker-agent/releases/tag/v1.128.0) - Docker Offload `v0.6.15` - Docker Desktop CLI v0.4.4 ### Bug fixes and enhancements #### For all platforms - Ask Gordon is now accessible as a right-side drawer, keeping users in context while chatting with Gordon alongside any page being viewed. - A container, image, or volume row with a detected issue now shows an Ask Gordon symbol that starts a diagnosis in one click. - Fixed a bug where generating a diagnostics bundle could hang until its timeout if a file it collects was on an unresponsive filesystem. - Fixed an issue where changing the auto-pause timeout while Docker Desktop was already idle would not apply until the original timer expired. - Fixed a crash in the **Images** view that occurred when many images loaded simultaneously on cold launch or after waking from Resource Saver mode. - Fixed a Docker Desktop Dashboard crash issue. Fixes [docker/desktop-feedback#611](https://github.com/docker/desktop-feedback/issues/611). - Added support for starting and stopping a Kubernetes cloud cluster via Docker Offload, with configurable Kubernetes version and node count. - The Docker Desktop Dashboard now displays the specific reason Docker Engine failed to start, when available. - Fixed a bug where `renameat2(RENAME_EXCHANGE)` on a shared folder overwrote the target instead of swapping the two files. - Fixed a bug where `mmap()` of a file on a Synchronized File Share failed with "No such device", breaking git and pnpm. Fixes [docker/desktop-feedback#627](https://github.com/docker/desktop-feedback/issues/627). - Fixed a bug where repeatedly replacing files on a shared folder leaked VM disk space until Docker Desktop was restarted. Fixes [docker/desktop-feedback#619](https://github.com/docker/desktop-feedback/issues/619). - Fixed a bug where a bind-mount root intermittently reported ownership as 0:0, causing git to report "detected dubious ownership". Fixes [docker/desktop-feedback#628](https://github.com/docker/desktop-feedback/issues/628). #### For Mac - Fixed an installer crash that occurred when the user's home folder was on a different disk than `/Applications`. Fresh installs and auto-updates now complete successfully in this configuration. - Fixed startup failures caused by `VZErrorInvalidVirtualMachineConfiguration` due to stale file locks on `Docker.raw` and APFS disk metadata sync races. #### For Windows - Fixed a startup hang where Docker Desktop would get stuck on 'Starting' after a WinGet upgrade due to conflicting engine settings in `install-settings.json`. - The Docker VMM engine option is now always available and no longer flips engines shortly after startup while feature flags load. - Fixed an issue where the `noWindowsContainers` setting in `install-settings.json` was cleared during a self-update, causing Windows containers to be re-enabled unexpectedly. - Added a prompt during in-app updates for all-users installations, offering users the option to migrate to a per-user installation that requires no admin privileges for future updates. - Fixed a bug where Docker Desktop could fail to start after an ungraceful shutdown left behind a stuck socket file. - Docker Desktop now checks that a Windows host can run Docker VMM before switching to it, and offers to switch back instead of leaving no working engine. - Fixed Docker VMM telling users to enable the Windows Hypervisor Platform feature when it was already enabled and the real cause was elsewhere. - Fixed a bug where a failing third-party WSL plugin (for example the Microsoft Defender for Endpoint plug-in for WSL) was reported as a missing Docker Desktop disk instead of naming the plugin that blocked WSL from starting. - Fixed the MSI installer ignoring `ENGINE=docker-vmm`, which left the Windows Hypervisor Platform feature disabled and the engine unselected. - Fixed a bug where running the installer with only command-line flags and no `install` verb failed with exit code `4294967291` and no error message. - Fixed a bug where Docker VMM did not explain how to fix an unavailable Windows Hypervisor Platform. ### Security - Updated the Kind cloud provider image to `v0.7.0`, addressing [CVE-2026-46595](https://github.com/advisories/GHSA-x527-x647-q7gg) and [CVE-2026-39834](https://github.com/advisories/GHSA-rm3j-f69w-wqmq). ## 4.89.0 2026-08-31 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/238018/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/238018/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/238018/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/238018/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/238018/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/238018/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/238018/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Compose v5.5.0](https://github.com/docker/compose/releases/tag/v5.5.0) - [NVIDIA Container Toolkit v1.20.0](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.20.0) - [Docker Agent v1.127.0](https://github.com/docker/docker-agent/releases/tag/v1.127.0) ### Bug fixes and enhancements #### For all platforms - Fixed an issue where background container and image polling was waking the Docker engine unnecessarily when Resource Saver mode was active. - Fixed slow Zsh startup caused by duplicated Docker CLI completion setup in `.zshrc`. Docker Desktop now keeps a single completion block and removes existing duplicates. Fixes [docker/desktop-feedback#561](https://github.com/docker/desktop-feedback/issues/561). - Sidebar customization permanently is now available to all users. Right-click the left-hand navigation, select **Customize**, and then select, deselect, or re-order the tabs. - Fixed the **Disk usage** slider in **Settings** to no longer show duplicate tick marks at small ranges, now displaying values in GiB with one decimal place for ranges up to 8 TiB. - Fixed excessive update notifications in the notification center so that pop-ups only appear for failures or when user action is required, not during in-progress update steps. - Fixed a dashboard crash issue. Fixes [docker/desktop-feedback#611](https://github.com/docker/desktop-feedback/issues/611) #### For Windows - When `CONTAINERD_BUILDX_FOR_WINDOWS` is enabled, Windows Containers now uses `dockerd`'s embedded containerd and in-process BuildKit, replacing the standalone containerd and buildkitd services. - Fixed a bug where Docker Desktop could fail to start after an ungraceful shutdown left behind a stuck socket file. - Fixed a bug where Docker VMM did not explain how to fix an unavailable Windows Hypervisor platform. ## 4.88.1 2026-08-25 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/237512/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/237512/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/237512/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/237512/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/237512/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/237512/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/237512/docker-desktop-x86_64.pkg.tar.zst) ### Bug fixes and enhancements #### For all platforms - Fixed an issue where opening the Dashboard would incorrectly redirect unauthenticated users to the sign-in prompt page. ## 4.88.0 2026-08-24 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/237115/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/237115/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/237115/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/237115/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/237115/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/237115/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/237115/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Agent v1.124.0](https://github.com/docker/docker-agent/releases/tag/v1.124.0) - Docker Offload `v0.6.13` - [Docker Model Runner v1.2.8](https://github.com/docker/model-cli/releases/tag/v1.2.8) - [containerd v2.3.3](https://github.com/containerd/containerd/releases/tag/v2.3.3) - [Runc v1.4.3](https://github.com/opencontainers/runc/releases/tag/v1.4.3) ### Bug fixes and enhancements #### For all platforms - Fixed an issue where Docker Desktop reported `enable fsverity failed: operation not supported` as the crash cause instead of the real underlying error. - Fixed a bug where changing the hypervisor type in **Settings** had no effect when Docker Desktop was in Resource saver mode. - Fixed port bindings reported by `docker ps` to accurately reflect active listeners when using 'Localhost by default' or 'Localhost only' settings, and added `[::1]` loopback listener alongside `127.0.0.1`. - Fixed an HTTP 500 error that could occur during Docker Desktop startup or wake from idle-shutdown when the engine socket existed but was not yet listening. - Fixed a bug where Docker Desktop would fail to start if `~/.docker/daemon.json` was corrupted with null bytes (typically caused by a crash or power-loss during a settings save). Docker Desktop now automatically recovers to default daemon settings. - Fixed an issue in the Docker Engine config editor in settings where validation error messages would disappear immediately while typing invalid JSON. - Fixed a Docker VMM regression that reduced container inbound network throughput to roughly 0.3 GB per second. - Fixed error messages shown when the Docker Desktop VM exits unexpectedly to include the exit status code and surface the actual root cause of the crash. #### For Mac - Docker VMM can now use more than 28GiB of host memory. #### For Windows - Fixed a Windows auto-update failure when a self-updated CLI plugin (e.g `docker scout` or `docker agent`) newer than the bundled version was already present in the user's CLI-plugins folder. - Fixed an issue on per-user Windows installs where Hyper-V, Windows containers, and related settings are now correctly disabled and grayed out, preventing broken behavior caused by the unavailable priveleged helper service. ## 4.87.0 2026-08-17 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/236836/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/236836/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/236836/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/236836/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/236836/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/236836/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/236836/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Agent v1.122.0](https://github.com/docker/docker-agent/releases/tag/v1.122.0) - [Docker Buildx v0.36.1](https://github.com/docker/buildx/releases/tag/v0.36.1) - Docker Offload `v0.6.10` - [Docker Compose v5.4.0](https://github.com/docker/compose/releases/tag/v5.4.0) - Linux kernel `v7.0.12` ### Bug fixes and enhancements #### For all platforms - Fixed a bug where the in-app update failed with `Source and destination path must have identical roots` when Docker Desktop was installed to a custom directory on another drive. - Fixed a misleading proxy error that named the destination server instead of the unreachable upstream proxy, and included machine-wide proxy configuration in diagnostics. - Fixed a bug where updating could keep failing with a `file exists` error after an earlier update had failed. - Fixed an issue where Gordon would lose access to tools and show misleading sign-in prompts after a failed auto-login at startup, without requiring a restart of Docker Desktop. #### For Mac - Fixed a false `Docker Desktop encountered an unexpected error` dialog that could appear during VM shutdown on with the `libkrun` engine. - Fixed a rare crash where the Docker Desktop with the Apple Virtualization Framework VM stopped unexpectedly right after a new connection was opened. #### For Windows - Fixed WSL error recovery on Windows not displaying specific, actionable error messages for errors like `HCS/0x80070569`, showing the generic fallback instead. - Fixed an issue on Windows where per-user `.EXE` installs applying an auto-update wrote `install-settings.json` to the system-wide path instead of the correct per-user location. - Fixed an issue on Windows where diagnostic bundles were missing network connection profile data due to an empty `Get-NetConnectionProfile.json` file. - Fixed a bug on Windows where Docker Desktop repeatedly asked users to run `wsl --update` when WSL was installed via the Microsoft Store rather than the inbox optional component. - Fixed an issue where the Resource Saver settings section was incorrectly shown when using Windows containers instead of Linux containers. - Fixed an issue on Windows where the disk image usage limit was hidden in **Resources** settings when Hyper-V was selected as the hypervisor. - Fixed an issue on Windows where installer logs from per-user installations were missing from diagnostic bundles. - Fixed the virtual disk limit not being applied when lowered on Windows with Hyper-V. - Fixed the disk usage limit slider being hidden and ignored for the Docker VMM backend on Windows, so users can now set and enforce disk size in **Settings** > **Resources** > **Advanced**. - Fixed a Windows auto-update failure when a self-updated CLI plugin (`docker scout` or `docker agent`) newer than the bundled version was already present in the user's CLI-plugins folder. ## 4.86.0 2026-08-10 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/236216/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/236216/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/236216/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/236216/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/236216/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/236216/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/236216/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Engine v29.7.2](https://docs.docker.com/engine/release-notes/29/#2972) - [Docker Buildx v0.36.0](https://github.com/docker/buildx/releases/tag/v0.36.0) - [Docker Scout CLI v1.24.0](https://github.com/docker/scout-cli/releases/tag/v1.24.0) - [Docker Agent v1.119.0](https://github.com/docker/docker-agent/releases/tag/v1.119.0) ### Bug fixes and enhancements #### For all platforms - Docker VMM Beta performance improvements by Docker’s own container-optimized hypervisor. Available for Mac and Windows. - Gordon now displays specific error messages for tool failures, policy-blocked actions, and loop detection instead of a generic **Agent error**. - Fixed container stop timeouts and `unless-stopped` restart policies not being honored during engine shutdown. - Fixed a bug where enabling Docker Offload from the Docker Desktop Dashboard failed when the proxy was configured by the operating system instead of by environment variables. - Fixed a crash on startup after upgrading, for users whose settings file was written by a very old version. - Fixed port forwarding for Swarm services that use automatically assigned published ports, including host-mode task ports and repeated ingress port definitions. - Added a three-mode safety system (Strict, Balanced, Autonomous) to the Gordon AI agent's tool confirmation UI, replacing the previous binary approve/allow-all dialog, with risk-tier labels on confirmation. - Fixed a flash of incorrect UI content on app launch, such as a brief 'Waiting for the Docker Engine...' screen or unexpected navigation away from gated pages. - AF_UNIX sockets shared over VirtioFS now work in both directions (host to guest and guest to host). - Fixed a bug where restarting the VM would steal the window focus. #### For Mac - Fixed a bug where a Kubernetes (kind) cluster with Enhanced Container Isolation could fail to recover after a Docker Desktop restart. - Fixed nftables `fib` expressions failing with "Operation not supported" in `inet` tables on Apple Silicon. #### For Windows - Fixed an issue where the Windows installer reported success when it could not write its settings or enterprise policy files. - Fixed Model Runner failing to start with `CreateJobObject: Access is denied` when Docker Desktop is launched via a Secondary Logon (run-as-user) session. - Updated the bundled 7-Zip to 26.02 to avoid antivirus software quarantining it during an upgrade on Windows. #### For Linux - Fixed Docker Desktop failing to start on Linux arm64 hosts due to incorrect QEMU binary path resolution. ### Security - Addressed CVE-2026-17106, a destination-escape flaw in `docker container cp`. ## 4.85.0 2026-08-03 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/235549/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/235549/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/235549/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/235549/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/235549/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/235549/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/235549/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker AI Agent v1.115.0](https://github.com/docker/docker-agent/releases/tag/v1.115.0) ### Bug fixes and enhancements #### For all platforms - Fixed an issue where native crash reports were uploaded to Bugsnag even when analytics was disabled by the user. - Fixed an issue where file content previews and diffs were hidden in the Gordon confirmation card when approving write or edit file actions. - Fixed an issue where an invalid `install-settings.json` caused a ~7-minute startup delay before showing the error dialog. The error now appears immediately. - Fixed an issue where Gordon's plan mode would silently revert to build mode after the first message, causing subsequent turns to run with full tool access despite plan mode appearing active. - Fixed an issue where an invalid `config.json` at startup would delay the error dialog by up to 7 minutes instead of appearing within seconds. - Fixed a Linux VM kernel panic that could hang Docker Desktop when a container's file watcher (inotify/fanotify) observed host-side changes to files on a bind mount. - Fixed Docker Hardened Images CLI ampersands being encoded when outputting JSON to the console. - Fixed a bug where extensions-related requests would fail on startup due to the extensions selector incorrectly defaulting to enabled before settings were loaded. - Fixed an issue where sub-agent message attribution was lost when reloading a historical multi-agent Gordon session, causing sub-agent messages to appear as if produced by the main agent. - Fixed Gordon's **Clean up Docker** suggestion prompt to propose a cleanup plan and wait for user confirmation before removing any resources, preventing unintended deletions. - Fixed the Gordon AI plan-mode toggle visibility to accurately reflect backend support, showing only when the connected agent declares plan capability. #### For Windows - Fixed a bug where per-user uninstalls of Docker Desktop on Windows failed with an unauthorized access error when attempting to revert the hosts file. - Added per-user install mode as the default for fresh Docker Desktop installations from the Microsoft Store on Windows, removing the need for admin privileges. - Fixed an issue where Docker Desktop crashed when the `docker-users` group is missing, now showing a recoverable group membership dialog instead. #### For Linux - Removing files on a host bind mount inside an Enhanced Container Isolation container no longer fails with "Value too large for data type". ## 4.84.0 2026-07-27 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/234817/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/234817/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/234817/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/234817/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/234817/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/234817/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/234817/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Agent v1.111.0](https://github.com/docker/docker-agent/releases/tag/v1.111.0) - Kubernetes: - cri-dockerd v0.4.4 - [Docker Hardened Images CLI (`dhictl`) v0.0.7](https://github.com/docker-hardened-images/dhictl/releases/tag/v0.0.7) - Docker Desktop CLI `v0.4.3` ### Bug fixes and enhancements #### For all platforms - Fixed a bug where an invalid `~/.docker/config.json` caused Docker Desktop to hang with high CPU/memory and show no error dialog. Docker Desktop now surfaces an error dialog prompting the user to correct the file. - Fixed a bug that prevented some Docker Hardened Images customizations from being created. - Fixed a bug where deleting an unrelated credential ID could accidentally erase Docker Hub OAuth tokens, causing users to be unexpectedly signed out. - Removed Docker Scout CLI hints that previously appeared after running `docker pull` or `docker buildx build` commands. #### For Windows - Fixed a bug on Windows where an empty or malformed `install-settings.json` caused Docker Desktop to hang with high CPU/memory usage and no error dialog on startup. - The MSI installer now detects per-user Docker Desktop installations on the machine and blocks installation with a clear message naming the affected users. Affected users must uninstall their per-user Docker Desktop before the MSI can be installed. - Fixed a bug where uninstalling Docker Desktop could permanently lock the user out of their own application data directories if the deletion failed mid-way. ## 4.83.0 2026-07-20 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/234302/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/234302/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/234302/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/234302/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/234302/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/234302/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/234302/docker-desktop-x86_64.pkg.tar.zst) ### Updates - Docker Desktop CLI `v0.4.2` - [Docker Model Runner v1.2.6](https://github.com/docker/model-runner/releases/tag/v1.2.6) - Docker Offload `v0.6.9` - [Docker Agent v1.103.0](https://github.com/docker/docker-agent/releases/tag/v1.103.0) - [Docker Compose v5.3.1](https://github.com/docker/compose/releases/tag/v5.3.1) - Docker Desktop Build `v0.36.0` - [Docker Engine v29.6.2](https://docs.docker.com/engine/release-notes/29/#2962) ### Bug fixes and enhancements #### For all platforms - Added support for migrating a per-machine Docker Desktop installation to a per-user installation in-place via `install --user` on Windows, preserving user data without requiring a manual uninstall. - Fixed `kubectl exec` and `kubectl attach` functionality for v1.36. - Fixed Docker Engine startup failures being reported as a generic `io: read/write on closed pipe` error instead of the underlying cause. - Fixed the **Images** view showing **0 Bytes** reclaimable size for a while when many images are present. - Fixed the volumes list not correctly sorting by size. - Fixed an issue where a GPU process crash prevented the Docker Desktop Dashboard from loading by automatically disabling hardware acceleration and restarting the app. - Fixed an issue where `docker ai` sessions launched directly from a terminal were killed when Docker Desktop was restarted. - Fixed an issue where a malformed `daemon.json` would be silently overwritten with defaults on startup, causing users to lose their custom daemon configuration. - Added a **Custom rules** tab to Gordon's permissions dialog. Users can now add allow/deny rules for specific commands or MCP tools. - Added pulsing discovery badges to Gordon's **Plan mode** button, model selector, and **Feedback/Issues** button to help users find new features. #### For Mac - Fixed an issue where a stale `com.docker.virtualization` process could prevent Docker Desktop from starting a new VM with a `VZErrorInvalidVirtualMachineConfiguration` error. #### For Windows - Fixed an issue where a failed delta update would leave users stranded on an old version by automatically falling back to the full installer. - Fixed the Windows MSI installer reporting success when the component installation step actually failed. - Fixed an issue where the Windows installer wizard froze while enabling Windows features via DISM during Docker Desktop installation. - Fixed a UI thread deadlock in the Windows installer that caused a blank or hung window when prerequisite services were registered but not running during admin installs. - Fixed the Windows installer silently reporting success when it could not install the Docker CLI plugins. - Fixed the Windows installer deleting a previously installed CLI plugin when re-linking it failed. - Fixed a bug where registry policy download failures were silently ignored, so users now see proper error reporting when the admin helper exits with a non-zero code. - Changed the Windows installer to select a per-user installation by default. - Fixed a WSL integration issue on WSL 2.6.x and later where Docker Desktop failed to work in user distros due to a 0-byte proxy binary, causing **Permission denied** or **Exec format error**. - Fixed the Docker CLI in integrated WSL distributions breaking after Resource Saver stopped the VM. The VM now stays running while a WSL integration is active and wakes when one is enabled. Fixes [docker/desktop-feedback#522](https://github.com/docker/desktop-feedback/issues/522). ## 4.82.0 2026-07-13 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/233772/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/233772/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/233772/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/233772/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/233772/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/233772/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/233772/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Compose v5.3.0](https://github.com/docker/compose/releases/tag/v5.3.0) - [Docker Agent v1.98.0](https://github.com/docker/docker-agent/releases/tag/v1.98.0) - [Docker Scout CLI v1.23.1](https://github.com/docker/scout-cli/releases/tag/v1.23.1) ### Bug fixes and enhancements #### For all platforms - Added thumbs up and thumbs down feedback buttons to Gordon responses. Users can rate replies or report issues directly from the chat. - Fixed a bug where containers created by Docker Desktop had their stop timeout set to 1 second instead of the Docker Engine default, causing `docker stop` to terminate processes too quickly. - Fixed reset to factory defaults not clearing MCP Toolkit profiles, catalogs, and authorizations. - Fixed an issue where selected thumbs up/down feedback buttons in Gordon were visually indistinguishable after selecting. - Fixed reset to factory defaults not clearing downloaded LLM models. - Fixed a bug where the Gordon chat area would go blank when the agent requested free-text input via elicitation. - Fixed a delay in the Kubernetes screen where the progress UI did not appear immediately after confirming cluster creation or deletion. - Fixed a bug where a Kubernetes kind cluster failed to start with a **Failed to get API server port** error after a Docker Desktop restart. - With `docker pass`, the `ls` command now behaves consistently across all platforms. - Fixed an issue where users signed out due to sign-in enforcement policies were shown a generic sign-in prompt instead of a clear explanation of why they were signed out. #### For Mac - Fixed an issue where Docker Desktop child processes could linger after an unexpected backend exit. - Fixed an issue where Docker Desktop failed to start for users with long home directory paths that caused Unix socket paths to exceed OS length limits. - Fixed an issue where vsock listener failures showed a cryptic crash instead of a clear, actionable recovery dialog. #### For Windows - Fixed an issue where `.log` files were missing from diagnostic bundles, ensuring the Docker Desktop service log is now included. - Lowered the priority of Docker Desktop's background processes and enabled Windows Efficiency Mode while idle to reduce power and CPU usage. - Fixed factory reset leaving containers and images behind on Hyper-V when Docker Desktop is run by a user other than the one that installed it. - Fixed a multi-minute hang during WSL engine startup when the wsl-bootstrap process fails unexpectedly, surfacing the error promptly instead. - Fixed an issue where auto-updates could leave Docker Desktop stuck in a 'connecting' state due to a successful installation being incorrectly rolled back. - Fixed an issue where vsock listener failures on Windows Hyper-V showed a cryptic crash instead of a clear, actionable recovery dialog. - Fixed a race condition where connecting to `com.docker.service` immediately after startup could result in a **File not found** error. - Fixed an issue where a graphical installer window would flash during background auto-updates. Updates now run silently. - Improved security by verifying the Authenticode signature of the downloaded installer before executing it during updates. - Fixed an issue where missing or disabled Windows feature descriptions were not shown in diagnostic output. - Improved the installer progress screen with a single continuous progress bar that smoothly advances from 0% to 100% throughout the entire installation. - Fixed an issue where `~` in bind mount paths was not correctly resolved to the home directory when the `HOME` environment variable was not set. #### For Linux - Fixed an issue where Docker Desktop failed to start for users with long home directory paths that caused Unix socket paths to exceed OS length limits. ## 4.81.0 2026-07-06 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/232925/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/232925/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/232925/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/232925/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/232925/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/232925/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/232925/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Model Runner v1.2.5](https://github.com/docker/model-runner/releases/tag/v1.2.5) - [Docker Agent v1.88.1](https://github.com/docker/docker-agent/releases/tag/v1.88.1) - Docker Offload `v0.6.7` - [Docker Compose v5.2.0](https://github.com/docker/compose/releases/tag/v5.2.0) - [Docker Scout CLI v1.22.0](https://github.com/docker/scout-cli/releases/tag/v1.22.0) - [DHI CLI (`dhictl`) v0.0.5](https://github.com/docker-hardened-images/dhictl/releases/tag/v0.0.5) ### Bug fixes and enhancements #### For all platforms - Fixed an error that caused volumes, images, and containers to fail to load in the Docker Desktop Dashboard. - Removed the deprecated `cagent` binary from Docker Desktop; use `docker agent` instead. - Kubernetes kind cluster now works with Registry Access Management. - Fixed a bug where the sign-in/update prompt was not shown when upgrading between versions that cross a version digit boundary (e.g., 4.9.x to 4.10.x). - Fixed an issue in Ask Gordon where the tool call permission dialog blocked the chat view, replacing it with an inline approval card so users can read Gordon's full message before approving or rejecting. - Fixed a rare case where Docker Desktop could shut down if the build service crashed, for example during a factory reset. - Fixed an issue where containers ignored user-configured stop timeouts during normal operation due to a proxy-level override forcing a 1-second timeout on all containers. #### For Mac - Fixed Docker Desktop failing to start when the user's environment contained very long environment variables. - Fixed a Docker Offload crash on Intel machines due to `SG_READ_ONLY` not being set in the `__DATA_CONST` segment, causing the system linker to fail to load the executable. Fixes [docker/desktop-feedback#471](https://github.com/docker/desktop-feedback/issues/471). #### For Windows - Fixed an issue on Windows where stopping Docker Desktop would immediately force off the Hyper-V VM without waiting for a graceful guest shutdown, reducing the risk of data corruption. - Fixed a bug on Windows where `dockerd` failed to connect through the local HTTPS proxy due to a TLS handshake error caused by an incorrect proxy URL scheme. - Fixed a Windows update that reverted and showed a **Mismatch patch version** error when it ran again after the target version was already installed. - Fixed Resource Saver not stopping the Docker engine when running on WSL. - Fixed a regression where Docker Desktop failed to start on WSL2 kernels that could not attach the Synchronized File Shares eBPF probes, such as Windows on Arm. Fixes [docker/desktop-feedback#470](https://github.com/docker/desktop-feedback/issues/470). #### For Linux - Fixed a bug where Docker Desktop would fail to start after a reset. ## 4.80.0 2026-06-29 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/232116/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/232116/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/232116/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/232116/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/232116/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/232116/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/232116/docker-desktop-x86_64.pkg.tar.zst) ### Updates - Docker Offload `v0.6.6` - [Docker Buildx v0.35.0](https://github.com/docker/buildx/releases/tag/v0.35.0) - [Docker Model Runner v1.2.4](https://github.com/docker/model-runner/releases/tag/v1.2.4) - [containerd v2.2.5](https://github.com/containerd/containerd/releases/tag/v2.2.5) - [Docker Engine v29.6.1](https://docs.docker.com/engine/release-notes/29/#2961) - [Runc v1.3.6](https://github.com/opencontainers/runc/releases/tag/v1.3.6) - Kubernetes v1.36.1 - CNI plugins v1.9.1 - cri-tools v1.35.0 - cri-dockerd v0.3.25 - Updated Kubernetes images: - Kubeadm: - `docker/desktop-storage-provisioner:v4.0` - `docker/desktop-vpnkit-controller:v4.0` - `docker/desktop-kubernetes-etcd:3.6.8-0` - `docker/desktop-kubernetes-coredns:v1.14.2` - `docker/desktop-kubernetes-pause:3.10.2` - `docker/desktop-kubernetes-apiserver:v1.36.1` - `docker/desktop-kubernetes-controller-manager:v1.36.1` - `docker/desktop-kubernetes-scheduler:v1.36.1` - `docker/desktop-kubernetes-proxy:v1.36.1` - Kind: - `docker/desktop-containerd-registry-mirror:v0.0.4` - `docker/desktop-cloud-provider-kind:v0.6.0` - `envoyproxy/envoy:v1.36.7` ### Bug fixes and enhancements #### For all platforms - The experimental `docker sandbox` plugin has been removed. Migrate to [`docker sbx`](/ai/sandboxes/). - Fixed an issue where running out of disk space showed a generic error dialog instead of a clear **Disk full** message prompting users to free up space and restart. - Fixed an issue where using `docker -c desktop-linux` while a cloud context was active would silently route commands to the cloud engine instead of the local desktop Linux engine. - Fixed a bug where the backend would incorrectly report a stopped VM as running after an idle shutdown, especially when Enhanced Container Isolation was enabled. - Fixed an OS update notification timing issue where users with auto-download enabled were notified when an update was available rather than when it was ready to install. #### For Mac - Removed the legacy osxfs file sharing. Users still on osxfs are migrated to VirtioFS. - Increased VirtioFS filesharing performance by not persisting (fake) file ownership changes on the host. Calls to `chown` will succeed, but `stat` will not be affected. #### For Windows - Fixed an issue where the Windows installer failed when the destination directory contained leftover files from a previous interrupted installation. - Fixed an issue on Windows where upgrading Docker Desktop would unnecessarily shut down and unregister unrelated WSL distros via `wsl --shutdown`. - Fixed spurious Hyper-V job failures on Windows where operations briefly transitioning through suspended or shutting down states were incorrectly reported as failed. - Fixed an issue where the WSL engine failed to start with a **Permission denied** error on machines where the cross-distro WSL mount was configured as `noexec`. - Fixed an issue on Windows where end users could override the `NO_PROXY` exclusion list even when an admin had locked the proxy configuration. - Fixed an issue on Windows where Docker Desktop would silently disappear on startup failure. An error dialog is now displayed instead. - Fixed an issue on Windows where Docker Desktop showed a generic engine-start failure instead of routing to the WSL update recovery when an older wsl.exe did not support the --version flag. ## 4.79.0 2026-06-22 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/230596/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/230596/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/230596/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/230596/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/230596/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/230596/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/230596/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Agent v1.79.0](https://github.com/docker/docker-agent/releases/tag/v1.79.0) - `docker pass` v0.1.5 - Docker Desktop CLI v0.4.1 - Docker Offload v0.6.4 ### Bug fixes and enhancements #### For all platforms - Gordon improvements: - Added context-aware suggested questions to the Ask Gordon menu in the **Containers**, **Images**, **Volumes**, and **Builds** tabs, surfacing relevant diagnostics first when items are in a problematic state. - Added a **Give feedback** link to Gordon so you can report issues with a redacted conversation preview or share product feedback. - Fixed a React warning in Gordon's sidebar search input that appeared on the first keystroke when typing a search query. - Fixed an issue where the Docker Engine settings editor displayed minified JSON instead of formatted JSON when first opened. - Fixed spurious 500 errors for Docker API calls made right after the VM woke from idle shutdown. - Fixed spurious 'Integrity issue detected' notifications caused by leftover symlinks from previously bundled binaries. - Fixed a broken documentation link in the error screen shown when the current user is not a member of the `docker-users` group. - Fixed a breaking change to the `/app/settings/grouped` API that caused integrations such as NVIDIA to stop working correctly. - Fixed high CPU usage (~30%) on macOS Retina displays caused by SVG animations in the Gordon landing page. - Fixed an issue where OAuth network errors caused Docker Desktop to incorrectly show users as signed out. - Fixed an issue where signing in via OAuth would not display the user's username and email in the UI after login. - QEMU has been updated to v10.2.3 - **Logs** view improvements - Added copy buttons. Copy all visible filtered logs at once or copy individual log entries on hover, respecting the current timestamp visibility setting. - Improved the toolbar with a reorganized layout, saved filter presets that now capture container selection and build log visibility, and the ability to persist container filter state. - Added the ability to clear logs. - Combined **copy** and **expand**/**collapse** buttons into a single pinned column that stays visible during horizontal scrolling, and fixed **copy** accidentally toggling the row detail pan. - Fixed Registry Access Management policy downloads to avoid `permission denied` errors by fetching and caching policies in the user's own directory with tampering detection. #### For Windows - Fixed a bug where Docker Desktop on WSL failed to start with an 'is already mounted' error after a force-killed bootstrap left stale rootfs mounts behind. - Fixed an issue on Windows where clicking "Quit Docker Desktop" had no effect when the backend had crashed or been killed. - Fixed an issue on Windows where Docker Desktop processes could linger as orphans after an unexpected exit or crash. - Fixed getting stuck on "Starting the Docker Engine…" after an in-place upgrade on Windows when the WSL virtual machine had not been shut down. - Fixed the tray icon on Windows not matching the system taskbar theme, so the correct light or dark icon is now displayed. - Fixed a silent failure on Windows where backend startup errors were only written to a log file. Users now see a visible error dialog box when Docker Desktop fails to start. ## 4.78.0 2026-06-15 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/229452/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/229452/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/229452/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/229452/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/229452/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/229452/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/229452/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Agent v1.73.0](https://github.com/docker/docker-agent/releases/tag/v1.73.0) - `docker pass` v0.1.4 - [Credential helpers v0.9.8](https://github.com/docker/docker-credential-helpers/releases/tag/v0.9.8) ### Bug fixes and enhancements #### For all platforms - Fixed an out-of-memory crash that would cause Docker Desktop to become unresponsive or crash while streaming logs in the Docker Desktop Dashboard. - Improved update reliability by retrying stalled and transient download failures and resuming from the partially downloaded file. - Added live streaming output to Gordon tool calls so long-running commands like `docker compose up` display STDOUT/STDERR in real time instead of waiting until completion. - Added color-coded labels to the **Logs** view so each container and build source is visually distinguished by a unique color in both the log grid and the container-filter dropdown. - Improved the error message when the Docker Desktop VM fails to start. It now shows the underlying `VirtualizationFramework` / `libkrun` reason instead of the generic **Use of closed network connection**. - Fixed a bug where Docker CLI error messages were shown as raw JSON instead of human-readable text while Docker Desktop was in Resource Saver mode. - Fixed a crash that occurred in the **Logs** view when deselecting a container filter. - Fixed an issue where the support page was replaced by the no-virtualization override screen when accessed from the troubleshooting popover. - Fixed an issue where Docker Desktop failed to start on bare metal EC2 instances (e.g. `g4dn.metal`) with a **Nested virtualization not supported** error. - Increased the retry delay to accommodate transient rename failures caused by antivirus software holding file locks. - Gordon now shows clear network error messages with guidance to check VPN, proxy, or firewall settings when outbound HTTPS to Docker's services is blocked, instead of a generic agent error. - Fixed the Gordon AI model picker incorrectly showing an internal model identifier instead of **Default** for sessions with no explicit model selection. #### For Windows - Fixed Docker Desktop getting stuck on **Starting the Docker Engine…** after an in-place upgrade. - Fixed a bug where Docker Desktop was not restarted after a failed update was reverted to the previous version. - Fixed delta updates failing to prepare. - Fixed an issue on Hyper-V where Docker commands (e.g. `docker login`) would fail on the first attempt after the engine had been idle-shut-down or paused. - Fixed an issue on Windows where Docker Desktop showed a generic engine-start failure instead of a clear, actionable error message when WSL is not installed. ## 4.77.0 2026-06-08 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/228796/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/228796/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/228796/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/228796/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/228796/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/228796/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/228796/docker-desktop-x86_64.pkg.tar.zst) ### New - You can now export log data from the **Logs** view. ### Updates - Docker Offload v0.6.3 - [Docker Buildx v0.34.1](https://github.com/docker/buildx/releases/tag/v0.34.1) - [Docker Agent v1.70.0](https://github.com/docker/docker-agent/releases/tag/v1.70.0) - [Docker MCP gateway v0.42.2](https://github.com/docker/mcp-gateway/releases/tag/v0.42.2) - `docker pass` v0.1.2 - [containerd v2.2.4](https://github.com/containerd/containerd/releases/tag/v2.2.4) - [DHI CLI (`dhictl`) v0.0.4](https://github.com/docker-hardened-images/dhictl/releases/tag/v0.0.4) - [Docker Engine v29.5.3](https://docs.docker.com/engine/release-notes/29/#2953) ### Bug fixes and enhancements #### For all platforms - Increased the retry delay to accommodate transient rename failures caused by antivirus software holding file locks. - Marketplace extensions are now installed and updated by pinned manifest digest, instead of by tag, protecting against tag mutation after publication. - Added Buildx version information to the About window. - Added a case-sensitivity toggle to the **Logs** search bar which lets you switch between case-insensitive (default) and case-sensitive log filtering. - Fixed a bug where the mouse wheel scroll was not working in the **Logs** view grid. - Fixed an issue where the backend incorrectly exited with error code 150 on clean shutdown via SIGINT or SIGTERM, causing false failure signals. - Removed the bundled `hub-tool` binary from Docker Desktop. - Added working **Authenticate** and **Cancel** buttons to the MCP OAuth authorization chat bubble in Gordon, letting you complete or decline OAuth sign-in flows from MCP servers. - Added two new commands to `docker pass`: - Use `docker pass run` to inject secrets into host commands. - Use `docker pass plugins` for dynamic plugin management. - Fixed a regression where `docker cp` into a container with Enhanced Container Isolation (ECI) enabled set file ownership to `nobody:nogroup`. #### For Windows - Fixed an issue on Windows where Docker Desktop would get stuck on **Starting the Docker Engine...** after a failed WSL distro registration left a VHDX on disk. - Fixed a backend shutdown hang in Windows Containers mode that caused Docker Desktop to take a long time or fail to exit cleanly. ## 4.76.0 2026-06-01 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/228118/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/228118/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/228118/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/228118/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/228118/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/228118/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/228118/docker-desktop-x86_64.pkg.tar.zst) ### New - Docker Model Runner now supports registry mirrors. ### Updates - [Docker Desktop Build v0.35.0](https://github.com/docker/desktop-build/releases/tag/v0.35.0) - [Docker Agent v1.62.0](https://github.com/docker/docker-agent/releases/tag/v1.62.0) - [NVIDIA Container Toolkit v1.19.1](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.19.1) - [Docker Compose v5.1.4](https://github.com/docker/compose/releases/tag/v5.1.4) - Docker Offload v0.5.93 - [Docker Scout CLI v1.21.0](https://github.com/docker/scout-cli/releases/tag/v1.21.0) - `docker pass` v0.0.29 ### Security - Addressed [CVE-2026-8936](https://www.cve.org/CVERecord?id=CVE-2026-8936), a VM panic caused by unbounded recursion in the `grpcfuse` kernel module when a container created deeply nested directories on a bind-mounted host folder and triggered a `dentry` invalidation event. ### Bug fixes and enhancements #### For all platforms - The `docker sbom` command has been deprecated and will be removed in a future release. Use the [`docker scout sbom command`](/reference/cli/docker/scout/sbom/) instead. - Fixed a race condition in Docker Engine when **Resource Saver** was active. - Fixed a bug where anonymous Docker volumes were leaked each time a `kind` cluster was deleted, causing orphaned volumes to accumulate. - Fixed column resizing in the **All Logs** grid so that **Timestamp** and **Object** columns no longer expand unexpectedly, and column widths are now preserved across navigation sessions. - Fixed an issue where Docker Desktop failed to start when a VM disk resize operation encountered an error, even if the underlying filesystem was healthy. - Fixed an issue that caused Docker Desktop to hang when quit. - Fixed a bug where CPU and RAM resource totals could get stuck showing 0 in the Docker Desktop Dashboard after stopping or starting Docker Offload. - Fixed a flicker in Gordon where the final answer text would briefly appear inside the working group before jumping to the response bubble. - Fixed a daemon panic that could occur during concurrent sign-out and token refresh operations. - Fixed a bug where the **Volumes** view showed incorrect mount targets for containers with multiple volumes. - `docker pass` now has a `--force` flag on the `set` command. - `docker --help` now shows `docker pass`. - Fixed stale API cache responses (synthetic 404s) for containers, images, networks, volumes, and plugins after restarting an idle-stopped engine via external API calls. - Fixed a bug where the **Delete** button on the **Builds** view might not be visible immediately after selecting a build. Fixes [docker/desktop-feedback#329](https://github.com/docker/desktop-feedback/issues/329) and fixes [docker/desktop-feedback#330](https://github.com/docker/desktop-feedback/issues/330). - Fixed time-namespaces being unavailable when Enhanced Container Isolation (ECI) is enabled. #### For Windows - Fixed a regression where the `--quiet` installer flag did not suppress the install-type dialog during silent installation. - Fixed a bug on Windows where a stale PID file with a trailing newline prevented the lingering daemon from being killed, leaving Windows Containers mode unconfigurable. - Fixed an issue on Windows where triggering an update while another installer instance was already running showed a generic error instead of a specific message. - Fixed an issue on Windows where the installer and updater executables incorrectly triggered UAC elevation prompts due to Windows heuristic installer detection. - Fixed double separator in the tray menu when running in Windows container mode. - Fixed port-binding failures on Windows Hyper-V where `docker run -p 0:N` could allocate HNS-reserved ports, causing bind errors. - Fixed garbled taskkill error messages in logs on non-English Windows systems (For example, Chinese Windows using GBK encoding). - Fixed unbounded growth of the WSL2 ISO cache. Old `docker-desktop.iso` and `docker-wsl-cli.iso` entries are now removed when a new version is installed. Fixes [docker/desktop-feedback#419](https://github.com/docker/desktop-feedback/issues/419). ## 4.75.0 2026-05-26 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/227598/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/227598/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/227598/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/227598/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/227598/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/227598/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/227598/docker-desktop-x86_64.pkg.tar.zst) ### Updates - Docker Offload v0.5.92 - [Docker Engine v29.5.2](https://docs.docker.com/engine/release-notes/29/#2952) - [Docker Buildx v0.34.0](https://github.com/docker/buildx/releases/tag/v0.34.0) ### Bug fixes and enhancements #### For all platforms - Removed the Docker Scout view and disabled Scout-related OS notifications and notification popups. - Added support for time namespacing in ECI protected containers. - Fixed a bug where the `http_proxy` environment variable could prevent kind clusters from pulling local images. - Fixed a `500 Internal Server Error` that could occur on the first Docker API call right after the VM wakes up from idle shutdown. - Fixed broken images in Docker Hub image descriptions caused by relative URLs being resolved to invalid `app://` scheme URLs. #### For Mac - Added a warning dialog that appears at startup when Docker Desktop is running from a staging directory due to a failed update. Also adds a link to download a fresh install. #### For Windows - WSL integration with the default distribution has been disabled. To change this, visit **Settings**. - Fixed a bug where `docker compose up` failed with an `EOF` error on Windows with a Hyper-V backend, when accepting a file-sharing consent prompt. - Fixed Windows installer bugs that could cause incorrect backend mode detection or unexpected directory creation during installation. ## 4.74.0 2026-05-19 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/227015/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/227015/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/227015/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/227015/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/227015/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/227015/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/227015/docker-desktop-x86_64.pkg.tar.zst) ### New - [Gordon](/ai/gordon) is now generally available. New usage plans are also available. Paid Gordon plans unlock higher usage limits. ### Updates - Docker Offload v0.5.89 - [Docker Agent v1.57.0](https://github.com/docker/docker-agent/releases/tag/v1.57.0) - [Credential helpers v0.9.7](https://github.com/docker/docker-credential-helpers/releases/tag/v0.9.7) - `docker pass` v0.0.26 ### Bug fixes and enhancements #### For all platforms - Fixed a bug where Docker Desktop's own Electron helper processes (GPU, renderer, utility) were incorrectly detected and killed as lingering processes on startup when launching from the Start menu, causing a crash loop. - Fixed an issue where the **View build logs** toggle in Logs view display settings was reset after restarting Docker Desktop instead of persisting the user's preference. - Docker Extensions is now disabled by default. #### For Mac - Fixed published ports being inaccessible when a container is also connected to a Swarm overlay network. Fixes [docker/for-mac#7854](https://github.com/docker/for-mac/issues/7854). - Fixed dashboard TLS failures in some corporate environments. - Improved GUI security via content hash validation. #### For Linux - Added support for Ubuntu 26.04. ## 4.73.1 2026-05-13 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/226574/Docker%20Desktop%20Installer.exe) ### Bug fixes and enhancements #### For Windows - Fixed a bug where Docker Desktop's own Electron processes were incorrectly killed when launching from the Start menu. Fixes [docker/desktop-feedback#367](https://github.com/docker/desktop-feedback/issues/367). ## 4.73.0 2026-05-11 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/226246/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/226246/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/226246/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/226246/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/226246/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/226246/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/226246/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Engine v29.4.3](https://docs.docker.com/engine/release-notes/29/#2943) - [Docker Agent v1.54.0](https://github.com/docker/docker-agent/releases/tag/v1.54.0) ### Bug fixes and enhancements #### For all platforms - Fixed `Cmd+Q` (Mac) and `Ctrl+Q` (Windows/Linux) not fully quitting Docker Desktop. Fixes [docker/for-mac#7833](https://github.com/docker/for-mac/issues/7833). - Fixed a bug where canceling `docker load` left a containerd ref lock held, causing subsequent loads of the same image to fail. - Fixed an issue where Docker Desktop made unnecessary network requests to `mcp.docker.com` on sign-in when MCP Toolkit was disabled, causing unexpected proxy authentication prompts. - Fixed an issue where the search input in Gordon's session sidebar would not close if it was left empty. - Improved Docker Desktop handling of transient rename failures caused by antivirus software accessing those files simultaneously. #### For Mac - Fixed excessive memory usage on Apple Silicon Macs by improving the Linux VM's ability to return freed container memory back to the host OS. - Fixed a bug where containers received connections with a corrupted source IP when another container had an active outbound connection to an IP in the same subnet range. Fixes [docker/for-mac#7824](https://github.com/docker/for-mac/issues/7824). ## 4.72.0 2026-05-06 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/225998/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/225998/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/225998/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/225998/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/225998/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/225998/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/225998/docker-desktop-x86_64.pkg.tar.zst) ### New - The **Logs** view is now generally available. - New installations of Docker Desktop for Windows have a choice between per-user (Beta) or all-user installs. ### Updates - [Docker Agent v1.50.0](https://github.com/docker/docker-agent/releases/tag/v1.50.0) - [Docker DHI (`dhictl`) v0.0.3](https://github.com/docker-hardened-images/dhictl/releases/tag/v0.0.3) - [Docker Model Runner v1.1.37](https://github.com/docker/model-cli/releases/tag/v1.1.37) - [credential helpers v0.9.6](https://github.com/docker/docker-credential-helpers/releases/tag/v0.9.6) ### Security - The Extensions settings page now includes a security notice that extensions run with host-level privileges and are not audited by Docker. - [Fixed CVE-2026-31431 ("copy.fail")](https://xint.io/blog/copy-fail-linux-distributions) by backporting an upstream Linux kernel patch that prevents an unprivileged container user from gaining root inside the container via a controlled write into the host VM page cache. ### Bug fixes and enhancements #### For all platforms - Improvements to Docker Offload idle notifications. - Fixed the **Open Gordon in TUI** button not working due to a missing `run` subcommand in Docker Agent command arguments. - Fixed an issue where transient network errors or Docker Hub server errors during sign-in would unexpectedly sign users out instead of retrying automatically. - Improved data refresh for the Containers, Images, and Volumes screens by fetching up-to-date data on demand when navigating to those screens, reducing background polling load. - Fixed a kernel crash that could occur when changing filesharing technology after significant container file activity. - Enable the OpenAI Responses API (`/responses`) endpoint in Docker Model Runner. - Fixed a bug where users were unexpectedly signed out of Docker Desktop mid-flow when signing in via `docker login` using OAuth. #### For Windows - Fixed a bug on Windows where selecting the Docker Desktop taskbar icon multiple times could spawn multiple backend processes. Re-selecting the icon while Docker Desktop is running now brings the dashboard to focus. - Fixed a race condition on Windows that caused a false-positive "processes still running" dialog to appear when Docker Desktop starts or exits normally. ### For Linux - Support for RHEL 8 has been dropped. ## 4.71.0 2026-04-27 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/225177/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/225177/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/225177/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/225177/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/225177/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/225177/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/225177/docker-desktop-x86_64.pkg.tar.zst) > [!IMPORTANT] > > Support for RHEL 8 has ended. Installing Docker Desktop will require RHEL 9 or RHEL 10 in the next release. ### Updates - [Docker Model Runner v1.1.36](https://github.com/docker/model-runner/releases/tag/v1.1.36) - [containerd to v2.2.3](https://github.com/containerd/containerd/releases/tag/v2.2.3) - [Runc v1.3.5](https://github.com/opencontainers/runc/releases/tag/v1.3.5) - [Docker Compose v5.1.3](https://github.com/docker/compose/releases/tag/v5.1.3) - [Docker Agent v1.44.0](https://github.com/docker/docker-agent/releases/tag/v1.44.0) - [Docker Engine v29.4.1](/engine/release-notes/29/#2941) ### Bug fixes and enhancements #### For all platforms - Docker Model Runner is now disabled by default and must be explicitly enabled in **Settings**. When enabled, TCP host-side support is automatically active. - Fixed an issue where downloading a Docker Desktop update would fail without a clear error if the disk had insufficient free space. - Fixed an issue where Docker Scout tag recommendations, when inspecting an image, failed when the base image digest or repository name was empty. - Added a **Switch to local Docker context** button on the sign-in screen, allowing users in a cloud context to switch back to their local context without signing in. - Added a dedicated **Stopped** status screen for the cloud engine so users see a clear stopped state instead of an error screen when transitioning away from Docker Offload. #### For Mac - Fixed an issue where error tracking would temporarily continue sending session data directly after a user disabled analytics. Fixes [docker/for-mac#7768](https://github.com/docker/for-mac/issues/7768). #### For Windows - Fixed a critical issue where Docker Desktop Dashboard failed to open with `ERR_FAILED` errors caused by process hardening policies conflicting with Chromium. - Fixed a bug where Kubernetes could fail to start on WSL 2 when `HTTP_PROXY` environment variables are set in WSL 2 itself. - Fixed a bug in Enhanced Container Isolation (ECI) that was causing loss of container `rootfs` persistence across Docker Desktop restarts, when using WSL. ### Security - Addressed [CVE-2026-5843](https://www.cve.org/cverecord?id=CVE-2026-5843), container-to-host code execution in the Docker Model Runner MLX inference backend via MLX-LM `model_file` importlib loading. ## 4.70.0 2026-04-20 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/224270/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/224270/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/224270/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/224270/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/224270/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/224270/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/224270/docker-desktop-x86_64.pkg.tar.zst) ### New - Added a CLI hint that surfaces the **Logs** view when running `logs`, `compose logs`, `compose attach`, or `compose up` commands, giving you quick access to logs across all running containers. Available with the **Logs** (Beta) feature enabled. ### Updates - [Docker Compose v5.1.2](https://github.com/docker/compose/releases/tag/v5.1.2) - [Docker Engine v29.4.0](/engine/release-notes/29/#2940) - [Docker Agent v1.43.0](https://github.com/docker/docker-agent/releases/tag/v1.43.0) - [Docker Model Runner v1.1.33](https://github.com/docker/model-runner/releases/tag/v1.1.33) - [Docker Scout CLI v1.20.4](https://github.com/docker/scout-cli/releases/tag/v1.20.4) ### Bug fixes and enhancements #### For all platforms - Fixed a bug where `docker login` could fail silently in CI environments due to slow Docker Hub responses causing credential store update timeouts. - Fixed an issue where disabling Beta features also disabled Docker Model Runner. - Fixed `docker desktop start` causing the Docker AI agent API daemon to fail due to an inherited CLI plugin environment variable. #### For Mac - Fixed a crash loop where Docker Desktop repeatedly failed to start with exit status `42` after an update due to a corrupted `DockerAppLaunchPath` setting. - Fixed an issue where a failed update could leave Docker Desktop in a broken state. The installer now automatically reverts to the previous version and shows a clear error message. - Fixed a bug where stopping one container could disrupt active Unix socket forwards belonging to other running containers. #### For Windows - Fixed an issue where a failed update could leave Docker Desktop in a broken state. The installer now automatically reverts to the previous version and shows a clear error message. - Fixed a bug where a failed switch to Windows containers could leave Docker Desktop in a broken state, requiring a restart. - Fixed an issue where Docker Desktop failed to launch for users with `DEVHOME` set in their environment. - Temporarily rolled back process hardening that caused Electron crashes on Windows. Fixes [docker/desktop-feedback#245](https://github.com/docker/desktop-feedback/issues/245). ## 4.69.0 2026-04-13 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/224084/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/224084/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/224084/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/224084/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/224084/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/224084/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/224084/docker-desktop-x86_64.pkg.tar.zst) ### Updates - [Docker Agent v1.42.0](https://github.com/docker/docker-agent/releases/tag/v1.42.0) - [Docker Model v1.1.29](https://github.com/docker/model-runner/releases/tag/v1.1.29) - [containerd v2.2.2](https://github.com/containerd/containerd/releases/tag/v2.2.2) - [Docker Buildx v0.33.0](https://github.com/docker/buildx/releases/tag/v0.33.0) ### Bug fixes and enhancements #### For all platforms - Fixed an issue where `docker logout` from the CLI was ignored by Docker Desktop when OAuth tokens remained in the credential store, leaving the user unexpectedly signed in. - Fixed an issue where Docker Desktop could unexpectedly sign users out when unrelated credential updates, `docker login`, or transient network errors triggered a sign-out. - Fixed a data loss issue where backup data could be deleted during a failed restore operation, leaving users with no data. - Fixed an issue where sign-in credentials (`login-info.json`) could be included in diagnostic bundles, improving privacy and security. Note that this file contains an encoded organisation(s) name, plan name, encoded username, and encoded email only. No passwords or credentials are included. - Fixed the footer update label incorrectly showing **Downloading** during the prepare/unpack phase of an update. It now correctly displays **Preparing**. - Fixed an issue where Docker Desktop would not start when the internal storage disk was full. #### For Mac - Fixed an issue where the in-app update button was not disabled when `Docker.app` was installed in a non-user-writable directory, preventing failed update attempts. - Fixed update failure for users who installed Docker Desktop via Homebrew on Mac. #### For Windows - Fixed an unexpected WSL terminal popup appearing for Windows users using the Hyper-V backend during Docker Desktop installation or uninstallation. - Fixed an issue on Windows where factory reset deleted CLI plugins from `~/.docker/cli-plugins`, causing `docker build` to fall back to the legacy builder. - Fixed a bug where Kubernetes failed to start when WSL integration was enabled alongside another distro using cgroup v1 controllers. - Fixed a race condition that caused Kubernetes to fail to start when a Registry Access Management policy change occurred during startup. - Prevent Docker Desktop from fatally failing due to transient 'Access is denied' errors during file operations on Windows. ## 4.68.0 2026-04-07 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/223695/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/223695/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/223695/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/223695/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/223695/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/223695/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/223695/docker-desktop-x86_64.pkg.tar.zst) ### New - Gordon now has persistent local memory, allowing it to remember your preferences and context across sessions. ### Updates - [Docker Agent v1.39.0](https://github.com/docker/docker-agent/releases/tag/v1.39.0) - [Docker Model v1.1.28](https://github.com/docker/model-runner/releases/tag/v1.1.28) - Docker Offload v0.5.81 ### Bug fixes and enhancements #### For all platforms - Fixed a deadlock in Enhanced Container Isolation that caused containers to hang indefinitely during creation when ECI was enabled. - Added a warning banner to alert when an MCP server is community-provided and has not been verified by Docker. - Added a persistent **Show timestamps** toggle to the **Logs** view, allowing timestamps to be hidden in both table and visualiser views across sessions. - Fixed an issue where Docker Desktop frontend processes were not properly terminated on quit. - Fixed a deadlock when settings controlled by admins reload that could cause Docker Desktop to become unresponsive during sign in or sign out operations. - Fixed a bug where Docker Desktop could fail to start due to uncorrectable filesystem errors on the disk image not being repaired. - Fixed a bug that caused Enhanced Container Isolation (ECI) to inadvertently block startup of Kubernetes clusters. - Fixed an issue where a failed volume size fetch could make the **Volumes** view inaccessible; container counts on volumes now correctly exclude bind mounts. - Fixed race conditions in volume backup that could cause containers to be incorrectly restarted, export logs to be corrupted, or runtime panics when scheduling tasks. - Fixed a crash in the API cache that occurred when containers with no names caused a panic disrupting container listing. - Fixed a bug where starting a container could fail with `ENOENT` if a bind-mount parent directory was deleted while no container was using it. #### For Mac - Fixed a security vulnerability where tampered user-deployed config profiles could bypass organization sign-in enforcement. - Fixed a bug where a failed `vmnetd` handshake could dispatch a bogus command on a broken connection, causing unexpected networking errors. - Fixed a bug where the Docker Desktop Dashboard could be prematurely displayed when restoring to a fullscreen state on launch. - Fixed nested bind mounts showing empty child mount content on VirtioFS when using Docker Compose with multiple services sharing a volume. Fixes [docker/desktop-feedback#264](https://github.com/docker/desktop-feedback/issues/264). #### For Windows - Fixed an issue where the installer extraction did not update the progress bar and could take around 5 minutes, depending on the machine. Extraction is now ~60% faster and includes proper progress updates. - Fixed a race condition where container ports would sometimes not be published correctly after container start, affecting ephemeral ports, `--publish-all`, and gateway IP bindings. - Fixed an issue where a failed WSL distro move could leave the distro unregistered. ### Security - Addressed [CVE-2026-5817](https://www.cve.org/cverecord?id=CVE-2026-5817), container-to-host code execution in the Docker Model Runner vllm-metal inference backend via unsandboxed `trust_remote_code` tokenizer loading. ## 4.67.0 2026-03-30 ### New - Docker MCP Toolkit now has MCP profile template cards and an onboarding tour accessible via the **Profiles** tab. ### Updates - [Docker Compose v5.1.1](https://github.com/docker/compose/releases/tag/v5.1.1) - [Docker Agent v1.34.0](https://github.com/docker/docker-agent/releases/tag/v1.34.0) - [Docker Scout CLI v1.20.3](https://github.com/docker/scout-cli/releases/tag/v1.20.3) - [Docker Model v1.1.25](https://github.com/docker/model-runner/releases/tag/v1.1.25) ### Bug fixes and minor changes #### For all platforms - Docker Model Runner now supports Qwen3.5. - With the new **Logs (Beta)** view, you can now filter container logs by Compose stack. - Improved interaction with **Settings** while the Docker engine or Kubernetes is starting or stopping. - Fixed a bug where random UDP port bindings reported port `0` instead of the actual assigned port. - Fixed an issue with the Docker Desktop shortcut not reopening the Dashboard when Docker Desktop was already running. - Fixed an issue where the **Add to existing profile** dialog showed profiles that already contained all selected MCP servers in the dropdown. #### For Mac - Fixed intermittent `exec format error` when starting amd64 containers on Apple Silicon Macs due to a race condition between Rosetta `binfmt` registration and `virtiofs` device availability. #### For Windows - Fixed Hyper-V being silently re-enabled on every EXE upgrade for WSL 2 users. - Fixed an MSI installer bug where Docker Desktop processes could be left running after uninstall. - Fixed an issue on Windows where installations or updates using `--installation-dir` would fail due to the installer archive being extracted into the custom installation directory. - Improved Docker Desktop startup time on Windows by several seconds when using WSL 2. - Fixed a bug on the **Models** > **Logs** screen which caused `docker-model` processes to accumulate on Windows each time the screen was visited. ### Security - Addressed [CVE-2026-33990](https://www.cve.org/cverecord?id=CVE-2026-33990), SSRF in Docker Model Runner OCI Registry Client ## 4.66.1 2026-03-26 ### Updates - [Docker Engine v29.3.1](/engine/release-notes/29/#2931) ## 4.66.0 2026-03-23 ### Updates - [Docker Engine v29.3.0](https://docs.docker.com/engine/release-notes/29/#2930) - [NVIDIA Container Toolkit v1.19.0](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.19.0) ### Bug fixes and minor changes #### For all platforms - Gordon improvements: - Provides pre-filled prompts when deeplinking from command-line failure hints. - Prevents Docker Hub rate limiting by authenticating before making requests. - Fixed a Kubernetes pod discovery hang when the kube context is broken or unreachable. - Fixed a terminal crash caused by an undefined dimensions error during terminal resize. - Fixed volume backup export error handling for file, image, and registry export operations. #### For Windows - Fixed high CPU usage in the Windows API proxy caused by unnecessary process enumeration. - Fixed the Windows MSI installer failing to update Docker Desktop. Versions between 4.56 and 4.65 need to uninstall before reinstalling version 4.66 or later. Note that uninstalling removes all associated data. ## 4.65.0 2026-03-16 ### New - Added a new **Logs** view where you can explore logs from all sources in one unified view. (Beta) - Gordon hints now appear when `docker build`, `docker run`, or `docker compose` commands fail, offering contextual suggestions. - Community MCP servers now support OAuth authentication directly in the UI. - Added the [`docker dhi` CLI plugin](https://github.com/docker-hardened-images/dhictl) for managing Docker Hardened Images. ### Updates - [Docker Scout CLI v1.20.1](https://github.com/docker/scout-cli/releases/tag/v1.20.1) - [Docker Agent v1.29.0](https://github.com/docker/docker-agent/releases/tag/v1.29.0) - [Docker Buildx v0.32.1](https://github.com/docker/buildx/releases/tag/v0.32.1) ### Bug fixes and minor changes #### For all platforms - Kubernetes now defaults to kind for new clusters. - Fixed update progress bar not resuming correctly. #### For Windows - Improved startup time by skipping docker-users group check when using WSL2 backend. ### Known issues - The Windows MSI installer cannot update an existing Docker Desktop installation when the current version is between 4.56 and 4.65. As a workaround, uninstall the existing version before reinstalling the latest version. Note that uninstalling removes all associated data. ## 4.64.0 2026-03-11 ### Updates - [Docker Compose v5.1.0](https://github.com/docker/compose/releases/tag/v5.1.0) - [Docker Scout CLI v1.20.0](https://github.com/docker/scout-cli/releases/tag/v1.20.0) - [Docker Agent v1.27.1](https://github.com/docker/docker-agent/releases/tag/v1.27.1) ### Bug fixes and minor changes #### For all platforms - Fixed a bug in MCP Toolkit where disabling all tools in a profile would enable all tools. - Fixed the `docker ai` command stopping after a Docker Agent update. - Fixed Gordon session title flickering when hover buttons appeared. - Improved Gordon summary rendering and reduced narrative verbosity. - Fixed a bug where `docker ai` CLI commands did not correctly shell out to Docker Agent. - Fixed the **OAuth** tab in Docker MCP Toolkit not showing entries from all catalogs. - Improved MCP Catalog search. - Fixed the **Build logs** tab not retaining search terms and filters when switching tabs. - Fixed Kind container startup to be more reliable. #### For Mac - Improved update error reporting with more descriptive diagnostics. - Improved update reliability by preparing the updated `Docker.app` under `Application Support` instead of `/tmp`. ### Known issues - The Windows MSI installer cannot update an existing Docker Desktop installation when the current version is between 4.56 and 4.65. As a workaround, uninstall the existing version before reinstalling the latest version. Note that uninstalling removes all associated data. ## 4.63.0 2026-03-02 ### New - Added SLSA v1 provenance support in the **Builds** view. ### Updates - [Kubernetes v1.34.3](https://github.com/kubernetes/kubernetes/releases/tag/v1.34.3) - Linux kernel `v6.12.72` ### Bug fixes and minor changes #### For all platforms - Enhanced the proxy settings UI and added a separate proxy for containers. - Fixed an issue where community registry MCP catalogs failed to load when a server's config object contained `"required": null`. - Fixed an issue where `mcp-gateway` would hang when fetching secrets from the Secrets Engine while the Docker Desktop VM was in Resource Saver mode. - Rebranded "Docker AI" references to "Gordon". #### For Windows - Improved startup time on Windows. ### Known issues - The Windows MSI installer cannot update an existing Docker Desktop installation when the current version is between 4.56 and 4.65. As a workaround, uninstall the existing version before reinstalling the latest version. Note that uninstalling removes all associated data. ## 4.62.0 2026-02-23 ### New - With Docker MCP Toolkit, you can now use [profiles](/desktop/features/mcp-catalog-and-toolkit/profiles/) to organize your MCP servers into named collections. You can also create custom catalogs — curated collections of servers for your team or organization. ### Updates - Linux kernel `v6.12.69` ### Bug fixes and enhancements #### For all platforms - Fixed an issue where background update checks did not respect the **Automatically check for updates** setting when disabled. Fixes [docker/for-mac#3908](https://github.com/docker/for-mac/issues/3908). #### For Mac - Added support for vLLM Metal in Docker Model Runner. #### For Linux - Fixed a networking crash on QEMU 10.2.0 and later. ### Security - Addressed [CVE-2026-2664](https://www.cve.org/cverecord?id=CVE-2026-2664), out of bounds read in grpcfuse kernel module. - Addressed [CVE-2026-28400](https://www.cve.org/cverecord?id=CVE-2026-28400), runtime flag injection in Docker Model Runner. ### Known issues - The Windows MSI installer cannot update an existing Docker Desktop installation when the current version is between 4.56 and 4.65. As a workaround, uninstall the existing version before reinstalling the latest version. Note that uninstalling removes all associated data. ## 4.61.0 2026-02-18 ### New - You can now customize the left-hand navigation to show only the tabs that matter to you, and hide the ones that don’t. ### Updates - Linux kernel `v6.12.68` - [Docker Engine v29.2.1](https://docs.docker.com/engine/release-notes/29/#2921) - Docker Sandbox `v0.12.0` ### Bug fixes and enhancements #### For all platforms - Docker Sandboxes: - Added automated image caching to prevent re-downloading images unnecessarily. - Added Shell mode for blank coding agent sandboxes. - Added support for OpenCode. - Added support for mounting multiple workspaces. - Added experimental Linux support (single user only, UID 1000). - Added support for running in WSL 2. - Sandboxes now start in the current working directory if no path is provided. ### Known issues - The Windows MSI installer cannot update an existing Docker Desktop installation when the current version is between 4.56 and 4.65. As a workaround, uninstall the existing version before reinstalling the latest version. Note that uninstalling removes all associated data. ## 4.60.1 2026-02-10 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/218372/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/218372/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/218372/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/218372/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/218372/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/218372/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/218372/docker-desktop-x86_64.pkg.tar.zst) ### Bug fixes and enhancements #### For all platforms - Fixed a rare issue that crashed the Docker Desktop Dashboard after sign-in. ## 4.60.0 2026-02-09 ### New - Added a new `docker desktop diagnose` command to gather diagnostics. ### Bug fixes and enhancements #### For all platforms - Fixed `ping6 host.docker.internal`. - Enabled landlock LSM. - Docker Sandboxes improvements: - Improved agent system prompt with network access documentation - Fixed Gemini API key injection - Sandboxes now block `console.anthropic.com/claude.ai` in proxy default rules - Fix CLI help text for `run --help` - Improved terminal size handling ### Known issues - The Windows MSI installer cannot update an existing Docker Desktop installation when the current version is between 4.56 and 4.65. As a workaround, uninstall the existing version before reinstalling the latest version. Note that uninstalling removes all associated data. ## 4.59.1 2026-02-03 ### Bug fixes and enhancements #### For Mac - Fixed an issue where CPU usage could spike at regular intervals. Fixes [docker/for-mac#7839](https://github.com/docker/for-mac/issues/7839). ## 4.59.0 2026-02-02 ### Updates - Linux kernel `v6.12.67` - [Docker Compose v5.0.2](https://github.com/docker/compose/releases/tag/v5.0.2) - Docker Sandbox `v0.10.1` - [Docker Buildx v0.31.1](https://github.com/docker/buildx/releases/tag/v0.31.1) ### Bug fixes and enhancements #### For all platforms - Added Neo4j as a known publisher to the Docker MCP Catalog. - Fixed an issue where the **Models** tab would crash when displaying requests made via the Anthropic Messages API. #### For Mac - Fixed an issue where shared file permissions could be unintentionally modified when using DockerVMM. Fixes [docker/for-mac#7830](https://github.com/docker/for-mac/issues/7830). #### For Windows - Fixed an issue where container secrets injection could fail with `docker-pass`. - Temporarily disabled VHDX compaction for the WSL data disk to improve stability. ### Security - Fixed a security issue in enhanced container isolation where Docker socket mount permissions could be bypassed when using the `--use-api-socket` flag. ## 4.58.1 2026-01-29 Download Docker Desktop: - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/217134/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/217134/Docker.dmg) ### Bug fixes and enhancements #### For Mac - Fixed an issue where CPU usage could spike at regular intervals. Fixes [docker/for-mac#7839](https://github.com/docker/for-mac/issues/7839). ## 4.58.0 2026-01-26 ### New - A new version of [Docker Sandboxes](/ai/sandboxes/) is now available on Docker Desktop. It provides a secure, isolated, microVM-based environment for running coding agents. ### Updates - Linux kernel `v6.12.65` - [Credential helpers v0.9.5](https://github.com/docker/docker-credential-helpers/releases/tag/v0.9.5) - [Docker Engine v29.1.5](https://docs.docker.com/engine/release-notes/29/#2915) ### Bug fixes and enhancements #### For all platforms - Docker Model Runner now exposes an [Anthropic-compatible API](/ai/model-runner/api-reference/#anthropic-compatible-api). - Docker Desktop now supports UTF-8 BOM for `admin-settings.json` and `registry.json`. - Fixed an issue where admin settings incorrectly changed user proxy settings after a restart. > [!IMPORTANT] > > Starting with Docker Desktop version 4.59, installing an update from the tray menu will proceed without opening the Docker Desktop Dashboard. #### For Mac - Fixed a bug where shared file permissions could be modified inadvertently while using DockerVMM on macOS. Fixes [docker/for-mac#7830](https://github.com/docker/for-mac/issues/7830). #### For Windows - Fixed an issue where the installer failed because of special ACLs set on `ProgramData`. ### Security - Updated Kubernetes images to address CVEs. - Kind: - `docker/desktop-containerd-registry-mirror:v0.0.3` - `docker/desktop-cloud-provider-kind:v0.5.0` - Kubeadm: - `docker/desktop-vpnkit-controller:v4.0` - `docker/desktop-storage-provisioner:v3.0` - The `kind` dependency image `envoyproxy/envoy` was upgraded from v1.32.6 to v1.36.4. If you mirror `kind` images, ensure your mirrors are updated. ## 4.57.0 2026-01-19 ### Security - Fixed [CVE-2025-14740](https://www.cve.org/cverecord?id=CVE-2025-14740) where the Docker Desktop for Windows installer contained multiple incorrect permission assignment vulnerabilities in the handling of the `C:\ProgramData\DockerDesktop` directory. ### New - Docker Desktop now has a new issue tracker for all platforms at https://github.com/docker/desktop-feedback. Relevant, actively discussed issues from the previous platform-specific trackers will be migrated. ### Updates - [Docker Compose v5.0.1](https://github.com/docker/compose/releases/tag/v5.0.1) ### Bug fixes and enhancements #### For all platforms - Improved alignment of the Ask Gordon streaming indicator so it stays in sync with content on large screens. - Fixed a bug where `docker debug` failed on containers started with environment variables but no '='. For example, `docker run -e NONEXISTENT_ENV_VAR`. ## 4.56.0 2026-01-12 ### New - Docker Desktop now includes Docker Compose v5 which introduces a new official Go SDK. This SDK provides a comprehensive API that lets you integrate Compose functionality directly into your applications, allowing you to load, validate, and manage multi-container environments without relying on the Compose CLI. For more information, see the [Compose SDK docs](/compose/compose-sdk/). ### Updates - [containerd v2.2.1](https://github.com/containerd/containerd/releases/tag/v2.2.1) - [Docker Compose v5.0.0](https://github.com/docker/compose/releases/tag/v5.0.0) - [Docker Agent v1.18.6](https://github.com/docker/docker-agent/releases/tag/v1.18.6) ### Bug fixes and enhancements #### For all platforms - Fixed a panic in filesharing tests when containers don't have an IP address immediately after starting. - Added support for custom DNS entries in the LinuxKit VM with the `ExtraDNSEntries` configuration field. #### For Windows - Fixed a bug on Windows where removing the state directory would fail because log files were still open. - Fixed installations from the Microsoft Store wrongly advertizing a new update. - Fixed a crash when running `/sbin/ldconfig` in `ubuntu:22.04` ARM64 containers by upgrading QEMU from 8.1.5 to 10.0.4. This resolves a known issue reported in [docker/for-win#15004](https://github.com/docker/for-win/issues/15004). > [!NOTE] > > When running under ARM64 emulation, some `amd64` Go binaries built with older Go versions may still segfault. To avoid this, rebuild affected binaries using Go 1.25.4 or later. For details, see [golang/go#69255](https://github.com/golang/go/issues/69255) and the corresponding [Go commit](https://github.com/golang/go/commit/bf95b767394eb5643265f44c7b98bdbb85b897ce). #### For Linux - Fixed Kubernetes `hostPath` volume mounts failing on Linux hosts. Fixes [docker/desktop-linux#12](https://github.com/docker/desktop-linux/issues/12). ## 4.55.0 2025-12-16 ### Updates - [Docker Engine v29.1.3](https://docs.docker.com/engine/release-notes/29/#2913) - [Docker Agent v1.15.1](https://github.com/docker/docker-agent/releases/tag/v1.15.1) ### Bug fixes and enhancements #### For all platforms - Fixed an issue that caused Docker Desktop to get stuck during startup. - Improved the error message when the `daemon.json` is invalid. - Fixed performance issues on every keystroke within a long Ask Gordon session. - Fixed an issue that prevented Kubernetes in kubeadm mode from starting up when an organization has configured Registry Access Management to block Docker Hub. > [!IMPORTANT] > > Wasm workloads will be deprecated and removed in a future Docker Desktop release. ## 4.54.0 2025-12-04 ### New - Added support for vLLM in Docker Model Runner on Windows with WSL2 and NVIDIA GPUs. ### Bug fixes and enhancements #### For Mac - Fixed a bug where `/dev/shm` did not have enough permission for containers to write into. Fixes [docker/for-mac#7804](https://github.com/docker/for-mac/issues/7804). ### Upgrades - [Docker Buildx v0.30.1](https://github.com/docker/buildx/releases/tag/v0.30.1) - [Docker Engine v29.1.2](https://docs.docker.com/engine/release-notes/29/#2912) - [Runc v1.3.4](https://github.com/opencontainers/runc/releases/tag/v1.3.4) - [Docker Model Runner CLI v1.0.2](https://github.com/docker/model-runner/releases/tag/cmd%2Fcli%2Fv1.0.2) ### Security - Added a security patch to address [CVE-2025-13743](https://www.cve.org/cverecord?id=CVE-2025-13743) where Docker Desktop diagnostics bundles were found to include expired Hub PATs in log output due to error object serialization. ## 4.53.0 2025-11-27 ### Bug fixes and enhancements #### For all platforms - Fixed an issue where the Support Diagnostics tooling inadvertently captured expired Docker Hub authorization bearer tokens. ### Security - Added security patches to address CVEs [2025-52565](https://github.com/opencontainers/runc/security/advisories/GHSA-9493-h29p-rfm2), [2025-52881](https://github.com/opencontainers/runc/security/advisories/GHSA-cgrx-mc8f-2prm), and [2025-31133](https://github.com/opencontainers/runc/security/advisories/GHSA-qw9x-cqr3-wc7r) when using [Enhanced Container Isolation](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/). ## 4.52.0 2025-11-20 ### New - Added new port binding settings to Docker Desktop. This can also be controlled by administrators via Settings Management using the `admin-settings.json` file. - Added a new Docker Model Runner command. With `docker model purge` you can remove all your models. ### Upgrades - [Docker Engine v29.0.0](/engine/release-notes/29/#2900) - [Docker Model Runner v1.0.3](https://github.com/docker/model-runner/releases/tag/v1.0.3) - [Docker Model Runner CLI v1.0.0](https://github.com/docker/model-runner/releases/tag/cmd%2Fcli%2Fv1.0.0) - Docker MCP plugin `v0.28.0` ### Bug fixes and enhancements #### For all platforms - Docker MCP Toolkit improvements: - Amazon Q client support - OAuth DCR (Dynamic Client Registration) with Docker Engine - Create MCP profiles using the CLI - Docker Model Runner improvements: - You can now skip the `/engines` prefix for [Docker Model Runner's OpenAI API endpoint](/ai/model-runner/api-reference/#rest-api-examples) `curl http://localhost:12434/v1/models`. - You can now skip the `ai/` prefix for the models [published on Docker Hub with](https://hub.docker.com/u/ai) `docker model pull`. - Downloads are now resumed when they get interrupted. #### For Windows - Fixed an issue with Kerberos/NTLM proxy sign in. ## 4.51.0 2025-11-13 ### New - You can now set up your Kubernetes resources from the **Kubernetes** view. This new view also provides a real-time display of your pods, services, and deployments. ### Upgrades - [Docker Engine v28.5.2](/engine/release-notes/28/#2852) - Linux kernel `v6.12.54` ### Bug fixes and enhancements #### For all platforms - Kind now only pulls required dependency images if they are not available locally. ## 4.50.0 2025-11-06 ### New - [Dynamic MCP](/desktop/features/mcp-catalog-and-toolkit/dynamic-mcp/)(Experimental) is now available in Docker Desktop . - Introduced a new Welcome Survey to improve onboarding. New users can now provide information to help tailor their Docker Desktop experience. ### Upgrades - [Docker Compose v2.40.3](https://github.com/docker/compose/releases/tag/v2.40.3) - [NVIDIA Container Toolkit v1.18.0](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.18.0) ### Bug fixes and enhancements #### For all platforms - Docker Desktop now detects and attempts to avoid clashes between the "Docker subnet" and physical networks using RFC1918 addresses. For example if the host has a non-default route which overlaps with `192.168.65.0/24` then an alternative network will be chosen automatically. You can still override the choice as before via Docker Desktop settings and admin settings. - Docker Desktop no longer treats Stargz Snapshotter failures as fatal. If a failure occurs, Docker Desktop continues to run without the Stargz Snapshotter. - Ask Gordon no longer displays images with user provided URLs. - Ask Gordon now asks for confirmation before running all built-in and all user added MCP tools. ## 4.49.0 2025-10-23 > [!IMPORTANT] > > Support for Windows 10 21H2 (19044) and 11 22H2 (22621) has ended. Installing Docker Desktop will require Windows 10 22H2 (19045) or Windows 11 23H2 (22631) in the next release. ### Security - Fixed [CVE-2025-9164](https://www.cve.org/cverecord?id=CVE-2025-9164) where the Docker Desktop for Windows installer was vulnerable to DLL hijacking due to insecure DLL search order. The installer searches for required DLLs in the user's Downloads folder before checking system directories, allowing local privilege escalation through malicious DLL placement. ### New - [Docker Agent](/ai/docker-agent/) is now available through Docker Desktop. - [Docker Debug](/reference/cli/docker/debug/) is now free for all users. ### Upgrades - [Docker Engine v28.5.1](/engine/release-notes/28/#2851) - [Docker Compose v2.40.2](https://github.com/docker/compose/releases/tag/v2.40.2) - [NVIDIA Container Toolkit v1.17.9](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.17.9) - Docker Debug `v0.0.45` ### Bug fixes and enhancements #### For all platforms - Fixed an issue where Docker Desktop used an expired proxy password while waiting for the user to enter a new one. - Fixed a 'chown' error shown on startup with Docker Debug. - Fixed a bug that caused some forwarded UDP ports to hang. #### For Mac - Fixed Kubernetes startup hanging when another Kubernetes context was active. Fixes https://github.com/docker/for-mac/issues/7771. - If a Rosetta install is cancelled or fails, Rosetta will be disabled in Docker Desktop. - Minimum OS version to install or update Docker Desktop on macOS is now macOS Sonoma (version 14) or later. ## 4.48.0 2025-10-09 > [!IMPORTANT] > > Support for macOS 13 has ended. Installing Docker Desktop will require macOS 14 in the next release. ### New - You can now specify PAC files and Embedded PAC scripts with installer flags for [macOS](/desktop/setup/install/mac-install/#proxy-configuration) and [Windows](/desktop/setup/install/windows-install/#proxy-configuration). - Administrators can set proxy settings via [macOS configuration profiles](/desktop/enterprise/enforce-sign-in/methods/#macos-configuration-profiles-method-recommended). ### Upgrades - [Docker Compose v2.40.0](https://github.com/docker/compose/releases/tag/v2.40.0) - [Docker Buildx v0.29.1](https://github.com/docker/buildx/releases/tag/v0.29.1) - [Docker Engine v28.5.1](https://docs.docker.com/engine/release-notes/28/#2851) - Docker MCP plugin `v0.22.0` - [Docker Model CLI v0.1.42](https://github.com/docker/model-cli/releases/tag/v0.1.42) ### Bug fixes and enhancements #### For all platforms - Fixed an issue where kind cluster state is sometimes reset when Desktop restarts. Fixes [docker/for-mac#77445](https://github.com/docker/for-mac/issues/7745). - Removed the obsolete `mcp` key to align with the latest VS Code MCP server changes. - Update credential helpers to [v0.9.4](https://github.com/docker/docker-credential-helpers/releases/tag/v0.9.4). - Fixed an issue where Docker Desktop used an expired proxy password while waiting for the user to enter a new one. - Fixed a bug which caused Docker Desktop to regularly create new processes with Docker CLI tools under certain conditions. Fixes [docker/for-win#14944](https://github.com/docker/for-win/issues/14944). - Fixed a bug which caused models to not be configured for embeddings with Docker Model Runner via Compose. To specify that a model should be configured for embeddings, you must explicitly add the `--embeddings` runtime flag as described in [AI Models in Docker Compose](https://docs.docker.com/ai/compose/models-and-compose/#model-configuration-options). Fixes [docker/model-runner#166](https://github.com/docker/model-runner/issues/166). #### For Windows - Removed the `HKLM\SOFTWARE\Docker Inc.\Docker\1.0` registry key. Look for `docker.exe` in the path to find out where Docker Desktop is installed instead. - Fixed startup in WSL 2 mode when IPv6 has been disabled. ## 4.47.0 2025-09-25 ### Security - Fixed [CVE-2025-10657](https://www.cve.org/CVERecord?id=CVE-2025-10657) where the Enhanced Container Isolation [Docker Socket command restrictions](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/config/#command-restrictions) feature was not working properly in Docker Desktop 4.46.0 only (the configuration for it was being ignored). ### New - Added dynamic MCP server discovery and support to Docker's MCP catalog. - With Enhanced Container Isolation, administrators can now block `docker plugin` and `docker login` commands in containers with Docker socket mounts. - Added a new Docker Model Runner command. With `docker model requests` you can fetch requests and responses. ### Upgrades - [Docker Compose v2.39.4](https://github.com/docker/compose/releases/tag/v2.39.4) - [Kubernetes v1.34.1](https://github.com/kubernetes/kubernetes/releases/tag/v1.34.1) - [CNI plugins v1.7.1](https://github.com/containernetworking/plugins/releases/tag/v1.7.1) - [cri-tools v1.33.0](https://github.com/kubernetes-sigs/cri-tools/releases/tag/v1.33.0) - [cri-dockerd v0.3.20](https://github.com/Mirantis/cri-dockerd/releases/tag/v0.3.20) - Docker Debug `v0.0.44` ### Bug fixes and enhancements #### For all platforms - You can now search for MCP servers more easily with filters, sorting, and improved search functionality. - Docker Debug no longer hangs when debugging containers that have environment variables set to an empty value. - Enhanced Docker Model Runner with rich response rendering in the CLI, conversational context in the Docker Desktop Dashboard, and resumable downloads. #### For Mac - Removed the `com.apple.security.cs.allow-dyld-environment-variables` entitlement which allow a signed, arbitrary dynamic library to be loaded with Docker Desktop via the `DYLD_INSERT_LIBRARIES` environment variable. - Fixed a regression where config profile sign-in enforcement broke for some customer environments. - Fixed a bug that sometimes caused the `docker model package` command to hang when writing to the local content store (without the `--push` flag). - Fixed a bug where containers started with the restart policy `unless-stopped` were never restarted. Fixes [docker/for-mac#7744](https://github.com/docker/for-mac/issues/7744). #### For Windows - Fixed the Goose MCP client connection on Windows for the Docker MCP Toolkit. - Addressed an issue with the "Skipping integration" of a WSL distro option, after a failed integration attempt. - Fixed a bug that sometimes caused the `docker model package` command to hang when writing to the local content store (without the `--push` flag). ## 4.46.0 2025-09-11 ### New - Added a new Learning center walkthrough for Docker MCP Toolkit and other onboarding improvements. - Administrators can now control [PAC configurations with Settings Management](/desktop/enterprise/hardened-desktop/settings-management/configure-json-file/#proxy-settings). - The update experience has been redesigned to make it easier to understand and manage updates for Docker Desktop and its components. ### Upgrades - [Docker Buildx v0.28.0](https://github.com/docker/buildx/releases/tag/v0.28.0) - [Docker Engine v28.4.0](https://docs.docker.com/engine/release-notes/28/#2840) ### Bug fixes and enhancements #### For all platforms - With the Docker CLI, you can now set the `GODEBUG` environment variable when the key-value pair (`"GODEBUG":"..."`) exists inside the Docker context metadata. This means certificates that have negative serial numbers in the CLI binaries are supported by default. - Updated the Docker Subscription Service Agreement link to point to the latest version. #### For Mac - Improved the security of Docker Model Runner by enabling sandboxing of the `llama.cpp` inference processes. - Fixed a bug which caused Docker Desktop to start slowly and appear frozen. Fixes [docker/for-mac#7671](https://github.com/docker/for-mac/issues/7671). #### For Windows - Improved the security of Docker Model Runner by enabling sandboxing of the `llama.cpp` inference processes. #### For Linux - Fixed a path issue in the RHEL post-uninstall sequence. ## 4.45.0 2025-08-28 ### New - [Docker Model Runner](/ai/model-runner/) is now generally available. ### Upgrades - [Docker Compose v2.39.2](https://github.com/docker/compose/releases/tag/v2.39.2) - [Docker Buildx v0.27.0](https://github.com/docker/buildx/releases/tag/v0.27.0) - [Docker Scout CLI v1.18.3](https://github.com/docker/scout-cli/releases/tag/v1.18.3) - [Docker Engine v28.3.3](https://docs.docker.com/engine/release-notes/28/#2833) ### Bug fixes and enhancements #### For all platforms - Fixed a bug that caused the `com.docker.diagnose` to crash when uploading a diagnostics bundle behind a proxy that requires authentication. - The `kind` dependency image `envoyproxy/envoy` was upgraded from v1.32.0 to v1.32.6. If you mirror `kind` images, ensure your mirrors are updated. #### For Mac - Fixed a bug that caused Docker Desktop to crash after the laptop woke from sleep. Fixes [docker/for-mac#7741](https://github.com/docker/for-mac/issues/7741). - Fixed an issue where the VM would sometimes fail with the error **The virtual machine stopped unexpectedly.** - Fixed a bug that would break port mappings when a container was connected to or disconnected from a network after it was started. Fixes [docker/for-mac#7693](https://github.com/docker/for-mac/issues/7693). #### For Windows - Fixed a bug that prevented CLI plugins from being deployed to `~/.docker/cli-plugins` by default when users lacked the correct permissions. - Fixed a bug where relocating the WSL data distribution would fail if the `docker-desktop` distribution was not present. - Fixed a typo in the WSL install URL in the Docker Desktop Dashboard. - Fixed an issue where certain WSL distros would fail to integrate. Fixes [docker/for-win#14686](https://github.com/docker/for-win/issues/14686) ## 4.44.3 2025-08-20 ### Security - Fixed [CVE-2025-9074](https://www.cve.org/CVERecord?id=CVE-2025-9074) where a malicious container running on Docker Desktop could access the Docker Engine and launch additional containers without requiring the Docker socket to be mounted. This could allow unauthorized access to user files on the host system. Enhanced Container Isolation (ECI) does not mitigate this vulnerability. ### Bug fixes and enhancements - Fixed a bug which caused the Docker Offload dialog to block users from accessing the dashboard. ## 4.44.2 2025-08-15 ### Bug fixes and enhancements - Adds [Docker Offload](/offload/) to the **Beta features** settings tab and includes updates to support [Docker Offload Beta](https://www.docker.com/products/docker-offload/). ## 4.44.1 2025-08-13 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/201842/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/201842/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/201842/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/201842/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/201842/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/201842/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/201842/docker-desktop-x86_64.pkg.tar.zst) ### Bug fixes and enhancements #### For all platforms - Fixed an issue found in version 4.44.0 that caused startup to fail when `vpnkit` CIDR is locked without specifying a value in Desktop Settings Management. #### For Windows - Fixed an issue where volumes and containers were not visible after an upgrade from distributions using the legacy `version-pack-data` directory structure. - Resolved a rare issue in WSL 2 where the Docker CLI failed with a **Proxy Authentication Required** error. - Fixed a bug where CLI plugins were not deployed to `~/.docker/cli-plugins` if the user lacked execution permissions on that directory. ## 4.44.0 2025-08-07 ### New - WSL 2 stability improvements. - You can now inspect requests and responses to help you diagnose model-related issues in Docker Model Runner. - Added the ability to run multiple models and receive a warning on insufficient resources. This avoids Docker Desktop freezing when using big models. - Added new MCP clients to the MCP Toolkit: Gemini CLI, Goose. - Introduced `--gpu` (Windows only) and `--cors` flags for `docker desktop enable model-runner`. - Added a new `docker desktop kubernetes` command to the Docker Desktop CLI. - You can now search for specific configuration options within **Settings**. - Apple Virtualization is now the default VMM for better performance and QEMU Virtualization is removed. See [blog post](https://www.docker.com/blog/docker-desktop-for-mac-qemu-virtualization-option-to-be-deprecated-in-90-days/). - Performance and stability improvements to the DockerVMM. ### Upgrades - [Docker Compose v2.39.1](https://github.com/docker/compose/releases/tag/v2.39.1) - [Docker Buildx v0.26.1](https://github.com/docker/buildx/releases/tag/v0.26.1) - [Docker Engine v28.3.2](https://docs.docker.com/engine/release-notes/28/#2832) - [Docker Scout CLI v1.18.2](https://github.com/docker/scout-cli/releases/tag/v1.18.2) - [Docker Model CLI v0.1.36](https://github.com/docker/model-cli/releases/tag/v0.1.36) - [Docker Desktop CLI v0.2.0](/desktop/features/desktop-cli/) ### Security We are aware of [CVE-2025-23266](https://nvd.nist.gov/vuln/detail/CVE-2025-23266), a critical vulnerability affecting the NVIDIA Container Toolkit in CDI mode up to version 1.17.7. Docker Desktop includes version 1.17.8, which is not impacted. However, older versions of Docker Desktop that bundled earlier toolkit versions may be affected if CDI mode was manually enabled. Upgrade to Docker Desktop 4.44 or later to ensure you're using the patched version. ### Bug fixes and enhancements #### For all platforms - Fixed an issue pulling images with zstd differential layers when the containerd image store is enabled. - Fixed a bug causing containers launching with the `--restart` flag to not restart properly when using Enhanced Container Isolation. - Improved interaction between [Kubernetes custom registry images](/desktop/use-desktop/kubernetes/#configuring-a-custom-image-registry-for-kubernetes-control-plane-images) and Enhanced Container Isolation (ECI), so the [ECI Docker Socket image list](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/config/) no longer needs to be manually updated when using a custom registry for Kubernetes control plane images. - Fixed a bug where a Docker Desktop Kubernetes cluster in kind mode fails to start after restarting Docker Desktop if the user is required to be signed in but is currently signed out. - Fixed a bug that prevented the mounting of MCP secrets into containers when [Enhanced Container Isolation](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/) is enabled. - Fixed a bug preventing the use of `--publish-all` when `--publish` was already specified. - Fixed a bug causing the **Images** view to scroll infinitely. Fixes [docker/for-mac#7725](https://github.com/docker/for-mac/issues/7725). - Fixed a bug which caused the **Volumes** tab to be blank while in Resource Saver mode. - Updated terms of service text on first launch. - More robustness in parsing newly released GGUF formats. #### For Mac - Fixed disk corruption on DockerVMM when reclaiming disk space. - Fixed regression since 4.42.0 on DockerVMM by re-introducing performance boost on general usage. - Removed QEMU hypervisor and switched to Apple Virtualization as the new default. See [blog post](https://www.docker.com/blog/docker-desktop-for-mac-qemu-virtualization-option-to-be-deprecated-in-90-days/). - Fixed a bug preventing Traefik from autodetecting containers' ports. Fixes [docker/for-mac#7693](https://github.com/docker/for-mac/issues/7693). - Fixed a bug that caused port mappings to break when a container was connected to or disconnected from a network after it was started. Fixes [docker/for-mac#7693](https://github.com/docker/for-mac/issues/7693#issuecomment-3131427879). - Removed eBPF which blocked `io_uring`. To enable `io_uring` in a container, use `--security-opt seccomp=unconfined`. Fixes [docker/for-mac#7707](https://github.com/docker/for-mac/issues/7707). - Docker Model Runner now supports GPT OSS models. #### For Windows - Re-added `docker-users` group to the named pipe security descriptors. - Fixed an installer crash when the current user has no `SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall` registry key. - Fixed a bug where Docker Desktop could leak a `com.docker.build` process and fail to start. Fixed [docker/for-win#14840](https://github.com/docker/for-win/issues/14840). - Fixed a bug that was preventing Docker Desktop Kubernetes in kind mode from starting when using WSL with `cgroups v1` and Enhanced Container Isolation (ECI) is enabled. - Fixed a typo in the WSL installation URL in the UI. - Docker Model Runner now supports GPT OSS models ## 4.43.2 2025-07-15 ### Upgrades - [Docker Compose v2.38.2](https://github.com/docker/compose/releases/tag/v2.38.2) - [Docker Engine v28.3.2](https://docs.docker.com/engine/release-notes/28/#2832) - Docker Model CLI v0.1.33 ## 4.43.1 2025-07-04 ### Bug fixes and enhancements #### For all platforms - Fixed an issue that caused Docker Desktop UI to break when Ask Gordon responses contained HTML tags. - Fixed an issue that prevented extensions from communicating with their backends. ## 4.43.0 2025-07-03 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/198134/Docker%20Desktop%20Installer.exe) - [Windows ARM Early Access](https://desktop.docker.com/win/main/arm64/198134/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/198134/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/198134/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/198134/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/198134/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/198134/docker-desktop-x86_64.pkg.tar.zst) ### New - [Compose Bridge](/compose/bridge/) is now generally available. ### Upgrades - [Docker Buildx v0.25.0](https://github.com/docker/buildx/releases/tag/v0.25.0) - [Docker Compose v2.38.1](https://github.com/docker/compose/releases/tag/v2.38.1) - [Docker Engine v28.3.0](https://docs.docker.com/engine/release-notes/28/#2830) - [NVIDIA Container Toolkit v1.17.8](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.17.8) ### Security - Fixed [CVE-2025-6587](https://www.cve.org/CVERecord?id=CVE-2025-6587) where sensitive system environment variables were included in Docker Desktop diagnostic logs, allowing for potential secret exposure. ### Bug fixes and enhancements #### For all platforms - Fixed a bug causing `docker start` to drop the container's port mappings for a container already running. - Fixed a bug that prevented container ports to be displayed on the GUI when a container was re-started. - Fixed a bug that caused Docker API `500 Internal Server Error for API route and version` error application start. - The settings **Apply & restart** button is now labeled **Apply**. The VM is no longer restarted when applying changed settings. - Fixed a bug where the disk would be corrupted if Docker is shutdown during a `fsck`. - Fixed a bug causing an incorrect `~/.kube/config` in WSL2 when using a `kind` Kubernetes cluster. - Return an explicit error to a Docker API / `docker` CLI command if Docker Desktop has been manually paused. - Fixed an issue where unknown keys in Admin and Cloud settings caused a failure. #### For Mac - Removed `eBPF` which blocked `io_uring`. To enable `io_uring` in a container, use `--security-opt seccomp=unconfined`. Fixes [docker/for-mac#7707](https://github.com/docker/for-mac/issues/7707). #### For Windows - Fixed an issue that caused the Docker Desktop installer to crash when the current user has no `SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall` registry key. - Fixed a bug where Docker Desktop could leak a `com.docker.build` process and fail to start. Fixes [docker/for-win#14840](https://github.com/docker/for-win/issues/14840) ### Known issues #### For all platforms - `docker buildx bake` will not build images in Compose files with a top-level models attribute. Use `docker compose build` instead. - Gordon responses containing HTML can cause Desktop UI to be permanently broken. As a workaround, you can delete `persisted-state.json` file to reset the UI. The file is located in the following directories: - Windows: `%APPDATA%\Docker Desktop\persisted-state.json` - Linux: `$XDG_CONFIG_HOME/Docker Desktop/persisted-state.json` or `~/.config/Docker Desktop/persisted-state.json` - Mac: `~/Library/Application Support/Docker Desktop/persisted-state.json` #### For Windows - Possible incompatibility between the "host networking" feature of Docker Desktop and the most recent WSL 2 Linux kernel. If you encounter such issues, downgrade WSL 2 to 2.5.7. ## 4.42.1 2025-06-18 ### Upgrades - [Docker Compose v2.37.1](https://github.com/docker/compose/releases/tag/v2.37.1) ### Bug fixes and enhancements #### For all platforms - Fixed an issue where Docker domains were not reachable when the proxy configuration is not valid. - Fixed a possible deadlock when exposing ports. - Fixed a race condition which can cause `docker run -p` ports to disappear. #### For Mac - Fixed a bug where a container’s port list appeared empty when inspected immediately after it was created, for example, when using a script. [docker/for-mac#7693](https://github.com/docker/for-mac/issues/7693) #### For Windows - Disabled the Resource Saver mode in WSL 2 to prevent `docker` CLI commands hanging in WSL 2 distros. [docker/for-win#14656](https://github.com/docker/for-win/issues/14656#issuecomment-2960285463) ## 4.42.0 2025-06-04 ### New - Expanded network compatibility with IPv6 support. - The Docker MCP Toolkit is now natively integrated into Docker Desktop. - Docker Model Runner is now available for Windows systems running on Qualcomm/ARM GPUs. - Added a **Logs** tab to the Models view so you can see the inference engine output in real time. - Gordon now integrates the MCP Toolkit, providing access to 100+ MCP servers. ### Upgrades - [Docker Buildx v0.24.0](https://github.com/docker/buildx/releases/tag/v0.24.0) - [Docker Engine v28.2.2](https://docs.docker.com/engine/release-notes/28/#2822) - [Compose Bridge v0.0.20](https://github.com/docker/compose-bridge-binaries/releases/tag/v0.0.20) - [Docker Compose v2.36.2](https://github.com/docker/compose/releases/tag/v2.36.2) - [NVIDIA Container Toolkit v1.17.7](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.17.7) - [Docker Scout CLI v1.18.0](https://github.com/docker/scout-cli/releases/tag/v1.18.0) ### Bug fixes and enhancements #### For all platforms - Docker Desktop now accepts certificates with a negative serial number. - Re-enable `seccomp` for containers by default. Use `docker run --security-opt seccomp=unconfined` to disable seccomp for a container. - Fixed a bug that caused Docker Desktop to hang when it ran out of memory. - Block `io_uring` syscalls in containers. - Added support for pulling models from Docker Hub directly, simplifying the process of accessing and using models. - Docker Desktop now sets the disk usage limit to the size of the physical disk on fresh install and reset to defaults on Mac and Linux. - The maximum disk size in the settings UI now aligns with the full capacity of the host file system. - The **Models** view now has a **Docker Hub** tab that lists models under the `ai` namespace. - Improved the sign-in enforcement message when more than 10 organizations are enforced. - Changed the way ports are mapped by Docker Desktop to fully support IPv6 ports. - Fixed a bug in the Dashboard container logs screen causing the scrollbar to disappear as the mouse approaches. - [Enforced sign-in](/desktop/enterprise/enforce-sign-in/) fixed for Teams subscription users. - `llama.cpp` server now supports streaming and tool calling in Model Runner. - Sign-in Enforcement capability is now available to all subscriptions. #### For Mac - Fixed a bug where the disk would always have a minimum usage limit of 64GB when using Docker VMM. - Disabled the memory protection keys mechanism in the Docker Desktop Linux VM. This caused VS Code Dev Containers to not work properly. See [docker/for-mac#7667](https://github.com/docker/for-mac/issues/7667). - Fixed persistent volume claims under Kubernetes. Fixes [docker/for-mac#7625](https://github.com/docker/for-mac/issues/7625). - Fixed a bug where the VM failed to start using Apple virtualization.framework. - Minimum version to install or update Docker Desktop on is now macOS Ventura 13.3. #### For Windows - Fixed a bug in Enhanced Container Isolation on Windows WSL, where files with hardlinks inside containers had `nobody:nogroup` ownership. - Fixed a bug that caused Docker Desktop to crash. Related to [docker/for-win#14782](https://github.com/docker/for-win/issues/14782). - Fixed a bug that caused `The network name cannot be found` error when starting with WSL 2. Fixes [docker/for-win#14714](https://github.com/docker/for-win/issues/14714). - Fixed an issue where Docker Desktop would not remove entries in the hosts file when uninstalling. - Fixed an issue when reading auto-start registry key for some system languages. Fixes [docker/for-win#14731](https://github.com/docker/for-win/issues/14731). - Fixed a bug where Docker Desktop was adding unrecognised /etc/wsl.conf `crossDistro` option which was causing WSL 2 to log an error. See [microsoft/WSL#4577](https://github.com/microsoft/WSL/issues/4577) - Fixed a bug where Docker Desktop failed to start on WSL 2.5.7 if another WSL distro is still using Linux cgroups v1. Fixes [docker/for-win#14801](https://github.com/docker/for-win/issues/14801) - Windows Subsystem for Linux (WSL) version 2.1.5 is now the minimum version required for proper functioning of Docker Desktop application ### Known issues #### For all platforms - This release contains a regression with `docker port`, resulting in "No host port found for host IP" errors when using testcontainers-node. See [testcontainers/testcontainers-node#818](https://github.com/testcontainers/testcontainers-node/issues/818#issuecomment-2941575369) #### For Windows - Running containers with Wasm will hang sporadically. See [docker/for-mac#7666](https://github.com/docker/for-mac/issues/7666). - On some machines Resource Saver will cause other WSL 2 distros to freeze. The workaround is to disable Resource Saver. See [docker/for-win#14656](https://github.com/docker/for-win/issues/14656). ## 4.41.2 2025-05-06 ### Bug fixes and enhancements #### For all platforms - Fixed an issue where the `Models` menu was displayed in the GUI even when Docker Model Runner was not supported or not enabled. ## 4.41.1 2025-04-30 ### Bug fixes and enhancements #### For all platforms - Fixed an issue where Docker Desktop failed to start when a proxy configuration was specified in the `admin-settings.json` file. #### For Windows - Fixed possible conflict with 3rd party tools (for example, Ollama) by avoiding placing `llama.cpp` DLLs in a directory included in the system `PATH`. ## 4.41.0 2025-04-28 ### New - Docker Model Runner is now available on x86 Windows machines with NVIDIA GPUs. - You can now [push models](/ai/model-runner/#push-a-model-to-docker-hub) to Docker Hub with Docker Model Runner. - Added support for Docker Model Runner's model management and chat interface in Docker Desktop for Mac and Windows (on hardware supporting Docker Model Runner). Users can now view, interact with, and manage local AI models through a new dedicated interface. - [Docker Compose](/compose/how-tos/models-and-compose/) and Testcontainers [Java](https://java.testcontainers.org/modules/docker_model_runner/) and [Go](https://golang.testcontainers.org/modules/dockermodelrunner/) now support Docker Model Runner. - Introducing Docker Desktop in the [Microsoft App Store](https://apps.microsoft.com/detail/xp8cbj40xlbwkx?hl=en-GB&gl=GB). ### Upgrades - [Docker Engine v28.1.1](https://docs.docker.com/engine/release-notes/28.1/#2811) - [Docker Compose v2.35.1](https://github.com/docker/compose/releases/tag/v2.35.1) - [Docker Buildx v0.23.0](https://github.com/docker/buildx/releases/tag/v0.23.0) - [Docker Scout CLI v1.17.1](https://github.com/docker/scout-cli/releases/tag/v1.17.1) - [Compose Bridge v0.0.19](https://github.com/docker/compose-bridge-binaries/releases/tag/v0.0.19) ### Security - Fixed [CVE-2025-3224](https://www.cve.org/CVERecord?id=CVE-2025-3224) allowing an attacker with access to a user machine to perform an elevation of privilege when Docker Desktop updates. - Fixed [CVE-2025-4095](https://www.cve.org/CVERecord?id=CVE-2025-4095) where Registry Access Management (RAM) policies were not enforced when using a MacOS configuration profile, allowing users to pull images from unapproved registries. - Fixed [CVE-2025-3911](https://www.cve.org/CVERecord?id=CVE-2025-3911) allowing an attacker with read access to a user's machine to obtain sensitive information from Docker Desktop log files, including environment variables configured for running containers. ### Bug fixes and enhancements #### For all platforms - Fixed a bug in DockerVMM that caused an excessive number of open file handles on the host. - Fixed an issue where Docker Desktop failed to start if the `admin-settings.json` file didn't contain the optional `configurationFileVersion` configuration. - Fixed a bug that was causing outgoing UDP connections to be eagerly closed. - Enhanced log reading experience with advanced search capabilities and container-level filtering, enabling quicker debugging and troubleshooting. - Improved error messages when downloading Registry Access Management configuration. - If Docker can't bind an ICMPv4 socket, it now logs an error and continues rather than quits. - Enabled the memory protection keys mechanism in the Docker Desktop Linux VM, allowing containers like Oracle database images to run correctly. - Fixed a problem with containers accessing `/proc/sys/kernel/shm*` sysctls when [Enhanced Container Isolation](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/) is enabled on Mac, Windows Hyper-V, or Linux. - Added kernel module `nft_fib_inet`, required for running firewalld in a Linux container. - MacOS QEMU Virtualization option is being deprecated on July 14, 2025. #### For Mac - Fixed a bug that caused high CPU usage. Fixes [docker/for-mac#7643](https://github.com/docker/for-mac/issues/7643). - Fixed multi-arch build issue with Rosetta on M3 Macs. - Fixed an issue where absence of `/Library/Application Support/com.docker.docker/` directory can cause failure to apply RAM policy restrictions. #### For Windows - The Windows `.exe` installer now includes improved handling of locked files. Fixes [docker/for-win#14299](https://github.com/docker/for-win/issues/14299) and [docker/for-win#14316](https://github.com/docker/for-win/issues/14316). - Fixed `Docker Desktop.exe` not showing version information after installation. Fixes [docker/for-win#14703](https://github.com/docker/for-win/issues/14703). ### Known issues #### For all platforms - If you have enforced sign-in using `desktop.plist` (on macOS) or Registry key (on Windows) and also have a `registry.json`, sign-in will fail if the user belongs to an organization listed in `desktop.plist`/ registry key but not to any organizations specified in `registry.json`. To resolve this, remove the `registry.json` file. #### For Windows - If multiple organizations are specified in the `allowedOrgs` Windows registry key using space-separated format, sign-in will fail and user will be logged out. As a workaround, specify each organization on a separate line in the registry key value. ## 4.40.0 2025-03-31 ### New - You can now pull, run, and manage AI models from Docker Hub directly in Docker Desktop with [Docker Model Runner (Beta)](/ai/model-runner/). Currently available for Docker Desktop for Mac with Apple Silicon. ### Upgrades - [Docker Buildx v0.22.0](https://github.com/docker/buildx/releases/tag/v0.22.0) - [Docker Compose v2.34.0](https://github.com/docker/compose/releases/tag/v2.34.0) - [Docker Engine v28.0.4](https://docs.docker.com/engine/release-notes/28/#2804) - [Docker Scout CLI v1.17.0](https://github.com/docker/scout-cli/releases/tag/v1.17.0) - [compose-bridge v0.0.18](https://github.com/docker/compose-bridge-binaries/releases/tag/v0.0.18) - [NVIDIA Container Toolkit v1.17.5](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.17.5) ### Bug fixes and enhancements #### For all platforms - Fixed a bug that caused `docker-proxy` to stop forwarding UDP datagrams to containers. - Fixed a bug that caused docker-proxy to close UDP connections to containers eagerly and resulting in the source address to change needlessly - Fixed a race condition that prevented Docker Desktop Kubernetes from starting in some scenarios. - Improved the way ECI collects image digest info from a repository in environments where proxies are configured. - Users can now to specify a timeout when generating a private Extension Marketplace using the new `--timeout` flag. - Removed unused internal helper tool `com.docker.admin` for Mac and Linux. #### For Mac - Fixed an issue where stale directory cache in Docker VMM that prevented detecting moved or new files. - Removed Continue/Restart pop up when Time Machine utility is restricted. - Docker Desktop now allows Unix domain sockets to be shared with containers via `docker run -v /path/to/unix.sock:/unix.sock`. The full socket path must be specified in the bind-mount. See [for-mac/#483](https://github.com/docker/for-mac/issues/483). - Fixed a bug that caused the `docker-credential-osxkeychain` and `docker-credential-desktop` to return malformed URIs when a token was stored for a server with a port specified. #### For Windows - The Windows MSI and `.exe` installers now disable Windows Containers by default when installing with the GUI. - Improved port-mapping throughput on WSL2. ### Known issues #### For Windows - Switching to Windows Containers while the privileged helper error message is displayed could cause inconsistent state. As a workaround, quit Docker Desktop, change `UseWindowsContainers` to `false` in `settings-store.json` and restart Docker Desktop. - After installation, `Docker Desktop.exe` does not contain the latest version information. ## 4.39.0 2025-03-05 ### New - The [Docker Desktop CLI](/desktop/features/desktop-cli/) is now generally available. You can now also print logs with the new `docker desktop logs` command. - Docker Desktop now supports the `--platform` flag on [`docker load`](/reference/cli/docker/image/load/) and [`docker save`](/reference/cli/docker/image/save/). This helps you import and export a subset of multi-platform images. ### Upgrades - [Docker Compose v2.33.1](https://github.com/docker/compose/releases/tag/v2.33.1) - [Docker Buildx v0.21.1](https://github.com/docker/buildx/releases/tag/v0.21.1) - [Kubernetes v1.32.2](https://github.com/kubernetes/kubernetes/releases/tag/v1.32.2) - [Docker Engine v28.0.1](https://docs.docker.com/engine/release-notes/28/#2801) - [Docker Scout CLI v1.16.3](https://github.com/docker/scout-cli/releases/tag/v1.16.3) ### Security - Fixed [CVE-2025-1696](https://www.cve.org/CVERecord?id=CVE-2025-1696) which could disclose proxy authentication credentials in plaintext in log files. ### Bug fixes and enhancements #### For all platforms - Ask Gordon now offers deeper context on Docker images, containers, and volumes, delivers faster support, and enables more user actions via Docker Desktop and the Docker CLI. - Support multi-platform images via enabling users to pick a specific platform in `docker history` - Fixed an issue that caused clients other than the CLI and Docker Desktop to see a delay of 3 seconds whenever a container with port-mappings exists. See [docker/for-mac#7575](https://github.com/docker/for-mac/issues/7575) - Fixed a bug in the ECI Docker socket permissions which caused it to sometimes block Docker socket mounts on containers with allowed images, or images derived from allowed images. - Fixed a bug that prevented Docker Desktop from entering Resource Saver mode again immediately after an engine restart. - Fixed an issue that caused Kubernetes clusters to stop working due to expired PKI certificates. #### For Mac - Downgraded Linux kernel to `v6.10.14` to fix a bug in OpenJDK that causes Java containers to terminate due to cgroups controller misidentification. See [docker/for-mac#7573](https://github.com/docker/for-mac/issues/7573). - Added `/usr/share/misc/usb.ids` in the root mount namespace to fix `usbip`. - Fixed an issue where the display of the CPU limit was capped at 8 when using Docker VMM. - Fixed an issue where startup would hang and the `com.docker.backend` process consumed 100% of the CPU. See [docker/for-mac#6951](https://github.com/docker/for-mac/issues/6951). - Fixed a bug that caused all Java programs running on M4 Macbook Pro to emit a SIGILL error. See [docker/for-mac#7583](https://github.com/docker/for-mac/issues/7583). - Blocked startup on macOS 15.4 beta 1 since starting VMs will cause the host to crash, see https://developer.apple.com/documentation/macos-release-notes/macos-15_4-release-notes#Virtual-Machines. - Fixed an issue where the myIPAddress PAC file function retrieved the host IP from the wrong interface, causing incorrect proxy selection. #### For Windows - Fixed a bug that prevented `docker compose log` to stream when running apps in WSL. - Fixed a bug where Paketo buildpacks failed with Enhanced Container Isolation when Docker Desktop uses WSL. - Fixed a bug where the WSL 2 integration would fail if WSL Version 1 distributions are installed. - Fixed a bug that caused some CLI plugins update to fail if WSL distributions were enabled. - Fixed a bug where Docker Desktop sign-in would hang when using a PAC file for proxy configuration, causing a blurred UI and blocking access. #### For Linux - The **Software Updates** page in settings, now points to the latest available version available. ## 4.38.0 2025-01-30 ### New - Installing Docker Desktop via the PKG installer is now generally available. - Enforcing sign-in via configuration profiles is now generally available. - Docker Compose, Docker Scout, the Docker CLI, and Ask Gordon can now be updated independently of Docker Desktop and without a full restart (Beta). - The new [`update` command](/reference/cli/docker/desktop/update/) has been added to the Docker Desktop CLI (Mac only). - [Bake](//build/bake/) is now generally available, with support for entitlements and composable attributes. - You can now create [multi-node Kubernetes clusters](/desktop/settings-and-maintenance/settings/#kubernetes) in Docker Desktop. - [Ask Gordon](/ai/gordon/) is more widely available. It is still in Beta. ### Upgrades - [containerd v1.7.24](https://github.com/containerd/containerd/releases/tag/v1.7.24) - [Docker Buildx v0.20.1](https://github.com/docker/buildx/releases/tag/v0.20.1) - [Docker Compose v2.32.4](https://github.com/docker/compose/releases/tag/v2.32.4) - [Docker Engine v27.5.1](https://docs.docker.com/engine/release-notes/27/#2751) - [Docker Scout CLI v1.16.1](https://github.com/docker/scout-cli/releases/tag/v1.16.1) - [Runc v1.2.2](https://github.com/opencontainers/runc/releases/tag/v1.2.2) - [NVIDIA Container Toolkit v1.17.4](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.17.4) - [Kubernetes v1.31.4](https://github.com/kubernetes/kubernetes/releases/tag/v1.31.4) - Docker Debug `v0.0.38` ### Bug fixes and enhancements #### For all platforms - Fixed a bug where access tokens generated by the `docker login` web flow could not be refreshed by Docker Desktop. - Fixed a bug where container creation via the Docker API using `curl` failed when [Enhanced Container Isolation](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/) was enabled. - Fixed a bug where the RAM policy was not refreshed after the refresh period had elapsed. - Fixed a bug in Enhanced Container Isolation when mounting the Docker socket into a container, and then creating Docker containers with bind-mounts from within that container. - Fixed an issue that caused a discrepancy between the GUI and the CLI, the former forcing the `0.0.0.0` HostIP in port-mappings. This caused default binding IPs configured through Engine's `ip` flag, or through the bridge option `com.docker.network.bridge.host_binding_ipv4`, to not be used. - Fixed a bug where the `pac` setting was ignored in `admin-settings.json`. - Build UI: - Added a progress status when importing a build. - Fixed a bug where users were unable to import builds. - Fixed a bug where some builders using SSH endpoints were not skipped. #### For Mac - Fixed a bug in Docker VMM where bind-mounts from non-root volumes would weren't working as expected. - Fixed an issue that caused startup failures on systems without IPv6. Fixes [docker/for-mac#14298](https://github.com/docker/for-win/issues/14298). - Fixed a bug that caused Docker Desktop to hang. See [docker/for-mac#7493](https://github.com/docker/for-mac/issues/7493#issuecomment-2568594070). - Fixed an issue where the uninstaller would fail if the settings file is missing. - Fixed a bug where config profiles deployed via Workspace One were ignored. #### For Windows - The Docker Desktop installer will now present a UAC prompt when launched. - Fixed an issue where Docker Desktop would fail to start for data disks created with old WSL versions that shared the same identifier as other WSL distros. - Docker Desktop now restarts when WSL integration settings are changed. This ensures proper setup of WSL integration when using Enhanced Container Isolation. #### For Linux - Added support for gvisor networking. Users with an incompatible version of qemu (8.x) will stay on qemu networking, and others will be migrated automatically. ### Deprecation #### For all platforms - Deprecated `com.docker.diagnose check|check-dot|check-hypervisordetect-host-hypervisor`. ## 4.37.2 2025-01-09 ### Bug fixes and enhancements #### For Mac - Prevents a bug that caused Docker Desktop to not update `com.docker.vmnetd` or `com.docker.socket` to newer versions. ### Known issues #### For Mac - If you’re seeing a security popup about malware on `com.docker.vmnetd` or `com.docker.socket`, follow the steps documented in [docker/for-mac#7527](https://github.com/docker/for-mac/issues/7527). ## 4.37.1 2024-12-17 ### Bug fixes and enhancements #### For all platforms - Fixed an issue that caused the AI Catalog in Docker Hub to be unavailable in Docker Desktop. - Fixed an issue that caused Docker Desktop to panic with `index out of range [0] with length 0` when using [Enhanced Container Isolation](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/). ### Known issues #### For Mac - If you’re seeing a security popup about a malware on `com.docker.vmnetd` or `com.docker.socket`, follow the steps documented in [docker/for-mac#7527](https://github.com/docker/for-mac/issues/7527). ## 4.37.0 2024-12-12 ### New - You can now perform key operations such as starting, stopping, restarting, and checking the status of Docker Desktop directly from the [command line](/desktop/features/desktop-cli/) (Beta). - The AI Catalog in Docker Hub is available directly through Docker Desktop. ### Upgrades - [Docker Buildx v0.19.2](https://github.com/docker/buildx/releases/tag/v0.19.2) - [Docker Compose v2.31.0](https://github.com/docker/compose/releases/tag/v2.31.0) - [Docker Engine v27.4.0](https://docs.docker.com/engine/release-notes/27/#2740) - [Docker Scout CLI v1.15.1](https://github.com/docker/scout-cli/releases/tag/v1.15.1) - [NVIDIA Container Toolkit v1.17.2](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.17.2) ### Bug fixes and enhancements #### For all platforms - The default disk usage limit for Docker Engine in new installations is now 1TB. - Fixed an issue where containers could not establish loopback `AF_VSOCK` connections. - Fixed a bug where resetting default settings would also reset the CLI context. - Fixed a bug where the Docker Desktop Dashboard would get out of sync with the Docker daemon after restarting the engine while in Resource Saver mode (Windows with WSL2 backend only) or after switching engines (macOS). - Fixed a bug where Resource Saver mode would fail to re-engage after restarting the engine while in Resource Saver mode. - Build UI: - Fixed a bug where the source file could not be found for some builds. - Fixed a bug where error logs were not displayed in the **Source** tab. - Fixed a bug where users had to scroll to the bottom for error logs in **Source** tab. - Fixed a bug where timestamps would be broken in the **Logs** tab. #### For Mac - Fixed a bug that would create certain user directories with root permission when running the uninstaller binary twice with `sudo`. #### For Windows - Added support for Windows on ARM using WSL 2 version 2.3.24 and later to single distribution mode on WSL 2. - Fixed an issue where Docker Desktop would fail to start. Fixes [docker/for-win#14453](https://github.com/docker/for-win/issues/14453) ### Known issues #### For all platforms - Kubernetes cluster may not start if **Registry Access Manager** is enabled. As a workaround, add `registry.k8s.io` and `-docker.pkg.dev` to **Registry Access Management** policies. #### For Mac - If you’re seeing a security popup about a malware on `com.docker.vmnetd` or `com.docker.socket`, follow the steps documented in [docker/for-mac#7527](https://github.com/docker/for-mac/issues/7527). ### Deprecation #### For Mac - QEMU (Legacy) as a VMM on Apple Silicon will be removed in a future version. It is recommended that you switch to the Apple Virtualization Framework for increased performance and stability. If you encounter an issue, [contact Docker Support](https://www.docker.com/support/) or [file a GitHub issue](https://github.com/docker/for-mac/issues). - osxfs (Legacy) will be removed in a future version. It is recommended that you switch to VirtioFS for increased performance. If you encounter an issue, [contact Docker Support](https://www.docker.com/support/) or [file a GitHub issue](https://github.com/docker/for-mac/issues). ## 4.36.1 2025-01-09 ### Bug fixes and enhancements #### For Mac - Prevents a bug that caused Docker Desktop to not update `com.docker.vmnetd` or `com.docker.socket` to newer versions. ### Known issues #### For Mac - If you’re seeing a security popup about malware on `com.docker.vmnetd` or `com.docker.socket`, follow the steps documented in [docker/for-mac#7527](https://github.com/docker/for-mac/issues/7527). ## 4.36.0 2024-11-18 ### New - Existing Docker Desktop installations using the WSL2 engine on Windows are now automatically migrated to a unified single-distribution architecture for enhanced consistency and performance. - Administrators can now: - Enforce sign-in with macOS [configuration profiles](/desktop/enterprise/enforce-sign-in/methods/#configuration-profiles-method-mac-only) (Early Access). - Enforce sign-in for more than one organization at a time (Early Access). - Deploy Docker Desktop for Mac in bulk with the [PKG installer](/desktop/enterprise/enterprise-deployment/pkg-install-and-configure/) (Early Access). - Use Desktop Settings Management to manage and enforce defaults via admin.docker.com (Early Access). - Enhance Container Isolation (ECI) has been improved to: - Allow admins to [turn off Docker socket mount restrictions](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/config/#allowing-all-containers-to-mount-the-docker-socket). - Support wildcard tags when using the [`allowedDerivedImages` setting](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/config/#docker-socket-mount-permissions-for-derived-images). ### Upgrades - [Docker Buildx v0.18.0](https://github.com/docker/buildx/releases/tag/v0.18.0) - [Docker Compose v2.30.3](https://github.com/docker/compose/releases/tag/v2.30.3) - [Kubernetes v1.30.5](https://github.com/kubernetes/kubernetes/releases/tag/v1.30.5) - [NVIDIA Container Toolkit v1.17.0](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.17.0) - [Docker Scout CLI v1.15.0](https://github.com/docker/scout-cli/releases/tag/v1.15.0) - Docker Init v1.4.0 - Linux kernel `v6.10.13` ### Bug fixes and enhancements #### For all platforms - Fixed a bug where the `docker events` command would not terminate after streaming the events. - Docker Init: Improved Dockerfile caching for PHP applications that don't use Docker Compose. - Synchronized file shares now respects the `filesharingAllowedDirectories` setting in `admin-settings.json`. - Fixed an issue where if Docker Desktop is configured to use a proxy, it fails to start due to an internal timeout while fetching authentication tokens. - Added a recovery banner to retry an update if the download failed. - Fixed an issue where if the `umask` is set to `577` it would cause `rpmbuild` failure. Fixes [docker/for-mac#6511](https://github.com/docker/for-mac/issues/6511). - Fixed a bug that restricted containers using `--network=host` to 18 open host ports. - Fixed bind mount ownership for non-root containers. Fixes [docker/for-mac#6243](https://github.com/docker/for-mac/issues/6243). - Docker Desktop will not unpause automatically after a manual pause. The system will stay paused until you manually resume the Docker engine. This fixes a bug where other software would accidentally trigger a resume by running a CLI command in the background. Fixes [for-mac/#6908](https://github.com/docker/for-mac/issues/6908) - Build UI: - The **Source** tab now supports multiple source files. - Links for image dependencies in the **Info** tab now support other well-known registries such as GitHub, Google, and GitLab. - Disabled the **Delete** button if only cloud builds are selected. - Fixed an issue where users were unable to delete builds. - Fixed malformed Jaeger traces that were missing events and links. - Fixed missing export attributes when building with the cloud driver. #### For Mac - Fixed a bug in Docker VMM that prevented MySQL and other databases containers to start. Fixes reports from [docker/for-mac#7464](https://github.com/docker/for-mac/issues/7464). - The minimum memory requirement is now automatically adjusted for Docker VMM, improving the user experience and addressing reports from [docker/for-mac#7464](https://github.com/docker/for-mac/issues/7464), [docker/for-mac#7482](https://github.com/docker/for-mac/issues/7482). - Fixed a bug where the advanced option **Allowed privileged port mapping** was not working as expected. Fixes [docker/for-mac#7460](https://github.com/docker/for-mac/issues/7460). - Docker Desktop can now automatically configure shell completion scripts for zsh, bash and fish inside the install wizard and settings screen. - Fixed a bug where the in-app update would fail if Docker Desktop was installed by a non-admin user or if the current user was previously an administrator. Fixes [for-mac/#7403](https://github.com/docker/for-mac/issues/7403) and [for-mac/#6920](https://github.com/docker/for-mac/issues/6920) #### For Windows - Fixed a bug preventing UDP port 53 to be bound. - Fixed a bug where Windows daemon options were overwritten at startup. ## 4.35.2 2025-01-09 ### Bug fixes and enhancements #### For Mac - Prevents a bug that caused Docker Desktop to not update `com.docker.vmnetd` or `com.docker.socket` to newer versions. ### Known issues #### For Mac - If you’re seeing a security popup about malware on `com.docker.vmnetd` or `com.docker.socket`, follow the steps documented in [docker/for-mac#7527](https://github.com/docker/for-mac/issues/7527). ## 4.35.1 2024-10-30 #### For all platforms - Fixed a bug where Docker Desktop would incorrectly bind to port `8888`. Fixes [docker/for-win#14389](https://github.com/docker/for-win/issues/14389) and [docker/for-mac#7468](https://github.com/docker/for-mac/issues/7468) ## 4.35.0 2024-10-24 ### New - Support for [Docker Desktop on Red Hat Enterprise Linux](/desktop/setup/install/linux/rhel/) is now generally available. - Volume Backup and Share is now generally available and can be found in the **Volumes** view. - Terminal support within Docker Desktop using system shells is now generally available. - Beta release of Docker VMM - the more performant alternative to Apple Virtualization Framework on macOS (requires Apple Silicon and macOS 12.5 or later). ### Upgrades - [containerd v1.7.21](https://github.com/containerd/containerd/releases/tag/v1.7.21) - [Docker Buildx v0.17.1](https://github.com/docker/buildx/releases/tag/v0.17.1) - [Docker Compose v2.29.7](https://github.com/docker/compose/releases/tag/v2.29.7) - [Docker Engine v27.3.1](https://docs.docker.com/engine/release-notes/27/#2731) - [Docker Scout CLI v1.14.0](https://github.com/docker/scout-cli/releases/tag/v1.14.0) - Docker Debug `v0.0.37` - Linux kernel `v6.10.9` ### Bug fixes and enhancements #### For all platforms - Fixed a bug where proxy settings in `daemon.json` would override proxies set in Docker Desktop settings. - Fixed a bug where some Docker subnet ranges were not able to be used. - Removed [docker-index](https://github.com/docker/index-cli-plugin) as it is now deprecated, you can use `docker scout cves fs://` instead. - Fixed a bug where images couldn't be sorted or filtered by tag. Fixes [docker/for-win#14297](https://github.com/docker/for-win/issues/14297). - Fixed a bug where the `docker` CLI did not work as expected when the `registry.json` file was malformed. - Fixed a bug where the **Push to Docker Hub** action in the **Images** view would result in an `invalid tag format` error. Fixes [docker/for-win#14258](https://github.com/docker/for-win/issues/14258). - Fixed an issue where Docker Desktop startup failed when ICMPv6 setup was not successful. - Added drivers that allow USB/IP to work. - Fixed a bug in Enhanced Container Isolation (ECI) [Docker socket mount permissions for derived images](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/config/) where it was incorrectly denying Docker socket mounts for some images when Docker Desktop uses the containerd image store. - Enable `NFT_NUMGEN`, `NFT_FIB_IPV4` and `NFT_FIB_IPV6` kernel modules. - Build UI: - Highlight build check warnings in the **Completed builds** list. - Improve visualization for the build time charts. - Image tags added to **Build results** section under the **Info** tab. - Improved efficiency of host-side disk utilization for fresh installations on Mac and Linux. - Fixed a bug that prevented the Sign in enforcement popup to be triggered when token expires. - Fixed a bug where containers would not be displayed in the GUI immediately after signing in when using [enforced sign-in](/desktop/enterprise/enforce-sign-in/). - `settings.json` has been renamed to `settings-store.json` - The host networking feature no longer requires users to be signed-in in order to use it. #### For Mac - Fixed a bug where auto-start containers could be misconfigured after changing filesharing type in settings. - Fixed a bug that would cause `~/.docker/cli-plugins` to not be populated on start-up. - Fixed a bug that prevented php composer or postgres to start as non root user. Fixes [docker/for-mac#7415](https://github.com/docker/for-mac/issues/7415). - Fixed a bug that could cause file changed on the host to appear truncated. Fixes [docker/for-mac#7438](https://github.com/docker/for-mac/issues/7438). #### For Windows - New installations of Docker Desktop for Windows now require a Windows version of 19045 or later. - Fixed an issue that caused a start failure if IPv6 is disabled either in the kernel config or via the kernel command-line in WSL. Fixes [docker/for-win#14240](https://github.com/docker/for-win/issues/14240) - Fixed the **Clean / Purge data** button on Windows. Fixes [docker/for-win#12650](https://github.com/docker/for-win/issues/14308). - Disk usage statistics is now displayed in the Dashboard footer installations. - Improved recovery for WSL distribution issues. #### For Linux - Ubuntu 24.04 is now supported on Docker Desktop. ### Known issues #### For Mac - Since version 4.34.0, the toggle "Allow privileged port mapping" in the Advanced settings does not work. For more information, see [docker/for-mac#7460](https://github.com/docker/for-mac/issues/7460). #### For Windows - Users with versions 4.14.0 and earlier could encounter issues using the in-app update. To update to the latest version, download and install the latest Docker Desktop from this page. ## 4.34.4 2025-01-09 ### Bug fixes and enhancements #### For Mac - Prevents a bug that caused Docker Desktop to not update `com.docker.vmnetd` or `com.docker.socket` to newer versions. ### Known issues #### For Mac - If you’re seeing a security popup about malware on `com.docker.vmnetd` or `com.docker.socket`, follow the steps documented in [docker/for-mac#7527](https://github.com/docker/for-mac/issues/7527). ## 4.34.3 2024-10-09 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/170107/Docker%20Desktop%20Installer.exe) - [Windows ARM Beta](https://desktop.docker.com/win/main/arm64/170107/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/170107/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/170107/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/170107/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/170107/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/170107/docker-desktop-x86_64.pkg.tar.zst) ### Upgrades - [NVIDIA Container Toolkit v1.16.2](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.16.2) ### Security - Fixed [CVE-2024-9348](https://www.cve.org/cverecord?id=CVE-2024-9348) which allows RCE via image build details source information - Fixed NVIDIA Container Toolkit [CVE-2024-0132](https://nvidia.custhelp.com/app/answers/detail/a_id/5582) - Fixed NVIDIA Container Toolkit [CVE-2024-0133](https://nvidia.custhelp.com/app/answers/detail/a_id/5582) ## 4.34.2 2024-09-12 ### 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](https://www.cve.org/cverecord?id=CVE-2024-8695) which allows RCE via crafted extension description/changelog which could be abused by a malicious extension. - Fixed [CVE-2024-8696](https://www.cve.org/cverecord?id=CVE-2024-8696) which allows RCE via crafted extension publisher-url/additional-urls which could be abused by a malicious extension. ## 4.34.1 2024-09-05 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/166053/Docker%20Desktop%20Installer.exe) - [Windows ARM Beta](https://desktop.docker.com/win/main/arm64/166053/Docker%20Desktop%20Installer.exe) ### 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](https://github.com/docker/for-win/issues/14294) and [docker/for-win#14034](https://github.com/docker/for-win/issues/14034)). ## 4.34.0 2024-08-29 ### New - [Host networking](/engine/network/drivers/host/#docker-desktop) 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](/desktop/features/wsl/best-practices/). - Deploying Docker Desktop via the [MSI installer](/desktop/enterprise/enterprise-deployment/msi-install-and-configure/) is now generally available. - Two new methods to [enforce sign-in](/desktop/enterprise/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](/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](https://docs.docker.com/engine/release-notes/27.2/#2720) - [Docker Compose v2.29.2](https://github.com/docker/compose/releases/tag/v2.29.2) - [containerd v1.7.20](https://github.com/containerd/containerd/releases/tag/v1.7.20) - [Docker Scout CLI v1.13.0](https://github.com/docker/scout-cli/releases/tag/v1.13.0) - [Docker Buildx v0.16.2](https://github.com/docker/buildx/releases/tag/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 Desktop 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](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-mac/issues/7377). #### For Windows - Fixed a bug where Docker Desktop would reset docker's `credsStore` to `desktop` when the user's intention is to keep it empty. Fixes [docker/for-win#9843](https://github.com/docker/for-win/issues/9843). - Fixed a bug that would cause Docker Desktop to not start in the WSL2 engine [docker/for-win#14034](https://github.com/docker/for-win/issues/14034). - Fixed a bug that caused WSL distribution to terminate abruptly. Fixes [docker/for-win/14230](https://github.com/docker/for-win/issues/14230). - Fixed an issue that caused WSL to update in each startup. Fixes [docker/for-win/13868](https://github.com/docker/for-win/issues/13868), [docker/for-win/13806](https://github.com/docker/for-win/issues/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 as `docker 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 running `docker 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 for `docker 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)](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/) 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](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/config/#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.2 2025-01-09 ### Bug fixes and enhancements #### For Mac - Prevents a bug that caused Docker Desktop to not update `com.docker.vmnetd` or `com.docker.socket` to newer versions. ### Known issues #### For Mac - If you’re seeing a security popup about malware on `com.docker.vmnetd` or `com.docker.socket`, follow the steps documented in [docker/for-mac#7527](https://github.com/docker/for-mac/issues/7527). ## 4.33.1 2024-07-31 ### 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](https://github.com/docker/for-win/issues/14222) ## 4.33.0 2024-07-25 Download Docker Desktop: - [Windows](https://desktop.docker.com/win/main/amd64/160616/Docker%20Desktop%20Installer.exe) - [Windows ARM Beta](https://desktop.docker.com/win/main/arm64/160616/Docker%20Desktop%20Installer.exe) - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/160616/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/160616/Docker.dmg) - [Linux (Debian)](https://desktop.docker.com/linux/main/amd64/160616/docker-desktop-amd64.deb) - [Linux (RPM)](https://desktop.docker.com/linux/main/amd64/160616/docker-desktop-x86_64.rpm) - [Linux (Arch)](https://desktop.docker.com/linux/main/amd64/160616/docker-desktop-x86_64.pkg.tar.zst) ### New - [Docker Debug](/reference/cli/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. - New and improved experience for [troubleshooting](/desktop/troubleshoot-and-support/troubleshoot/). ### Upgrades - [Docker Compose v2.29.1](https://github.com/docker/compose/releases/tag/v2.29.1) - [Docker Engine v27.1.1](https://docs.docker.com/engine/release-notes/27.1/#2711) - [containerd v1.7.19](https://github.com/containerd/containerd/releases/tag/v1.7.19) - [NVIDIA Container Toolkit v1.16.0](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.16.0) - [Docker Scout CLI v1.11.0](https://github.com/docker/scout-cli/releases/tag/v1.11.0) - [Kubernetes v1.30.2](https://github.com/kubernetes/kubernetes/releases/tag/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` and `fixed-cidr-v6`. Fixes [docker/for-mac#7104](https://github.com/docker/for-mac/issues/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](/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](/desktop/troubleshoot-and-support/faqs/macfaqs/). - 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](https://github.com/docker/for-mac/issues/7332). - Fixed an issue where the `docker-compose` symlink pointed to an empty location. Fixes [docker/for-mac#7345](https://github.com/docker/for-mac/issues/7345). #### For Linux - Fixed an issue where some `wincred` values were persisted after uninstall. Reported by Javier Yong [@Javiery3889](https://github.com/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](https://www.cve.org/cverecord?id=CVE-2024-41110). #### For Windows - Fixed an issue where some `wincred` values were persisted after uninstall. Reported by Javier Yong [@Javiery3889](https://github.com/Javiery3889). ### Known Issues #### For Windows - Docker Desktop fails to start with WSL pre-releases `v2.3.11.0` and `v2.3.12.0`, which is included in Windows 11 Insider. To fix this ensure WSL `v2.2.4.0` is installed. For more information, see [microsoft/WSL#11794](https://github.com/microsoft/WSL/issues/11794). This affects Docker Desktop 4.33.0 and earlier. ## 4.32.1 2025-01-09 Download Docker Desktop: - [Mac (Apple chip)](https://desktop.docker.com/mac/main/arm64/179691/Docker.dmg) - [Mac (Intel chip)](https://desktop.docker.com/mac/main/amd64/179691/Docker.dmg) ### Bug fixes and enhancements #### For Mac - Prevents a bug that caused Docker Desktop to not update `com.docker.vmnetd` or `com.docker.socket` to newer versions. ### Known issues #### For Mac - If you’re seeing a security popup about malware on `com.docker.vmnetd` or `com.docker.socket`, follow the steps documented in [docker/for-mac#7527](https://github.com/docker/for-mac/issues/7527). ## 4.32.0 2024-07-04 ### 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](https://github.com/docker/for-win/issues/13384). - You can now [schedule backups for volume exports](/desktop/release-notes/use-desktop/volumes/) in the **Volumes** tab (Beta). - Access a terminal shell directly from Docker Desktop (Beta). ### Upgrades - [Docker Buildx v0.15.1](https://github.com/docker/buildx/releases/tag/v0.15.1) - [Docker Compose v2.28.1](https://github.com/docker/compose/releases/tag/v2.28.1) - [Docker Scout CLI v1.10.0](https://github.com/docker/scout-cli/releases/tag/v1.10.0) - [Docker Engine v27.0.3](https://docs.docker.com/engine/release-notes/27/#2703) - 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](https://github.com/docker/roadmap/issues/611) - [Settings Management](/desktop/enterprise/hardened-desktop/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](/desktop/release-notes/use-desktop/builds/#import-builds). - 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](/desktop/setup/install/windows-permission-requirements/#privileged-helper) 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](https://github.com/docker/for-mac/issues/7286) and [docker/for-mac/7006](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/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 return `command 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 ### 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](https://github.com/docker/for-win/issues/14118). ## 4.31.0 ### New - [Air-Gapped Containers](/desktop/enterprise/hardened-desktop/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](https://github.com/moby/moby/releases/tag/v26.1.4). - [Docker Scout CLI v1.9.1](https://github.com/docker/scout-cli/releases/tag/v1.9.1) - [Docker Compose v2.27.1](https://github.com/docker/compose/releases/tag/v2.27.1) - [Docker Buildx v0.14.1](https://github.com/docker/buildx/releases/tag/v0.14.1) - [Containerd v1.6.33](https://github.com/containerd/containerd/releases/tag/v1.6.33) - [Credential Helpers v0.8.2](https://github.com/docker/docker-credential-helpers/releases/tag/v0.8.2) - [NVIDIA Container Toolkit v1.15.0](https://github.com/NVIDIA/nvidia-container-toolkit/releases/tag/v1.15.0) - [Go 1.22.4](https://github.com/golang/go/releases/tag/go1.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 to `settings.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](/desktop/enterprise/hardened-desktop/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](https://github.com/docker/for-mac/issues/7274), [docker/for-win#14060](https://github.com/docker/for-win/issues/14060). - Builds view: - New [Import builds](/desktop/release-notes/use-desktop/builds/#import-builds) feature that lets you import build records for builds by other people, or [builds in a CI environment](/build/ci/github-actions/build-summary/). - 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 the `registry.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](https://www.cve.org/cverecord?id=CVE-2024-5652) in which a user in the `docker-users` group can cause a Windows Denial-of-Service through the `exec-path` Docker daemon config option in Windows containers mode. This vulnerability was discovered by Hashim Jawad ([@ihack4falafel](https://github.com/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 as `docker`. This release leaves the CLI binary as `com.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](https://github.com/docker/for-win/issues/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](https://ubuntu.com/blog/). ## 4.30.0 2024-05-06 ### New #### For all platforms - Docker Desktop now supports [SOCKS5 proxies](/desktop/features/networking/#socks5-proxy-support). Requires a Business subscription. - Added a new setting to manage the onboarding survey in [Settings Management](/desktop/enterprise/hardened-desktop/settings-management/). #### For Windows - Added support for [Kerberos and NTLM proxy authentication](/desktop/settings-and-maintenance/settings/#proxy-authentication) on Windows. Requires a Business subscription. ### Upgrades - [Docker Compose v2.27.0](https://github.com/docker/compose/releases/tag/v2.27.0) - [Docker Engine v26.1.1](https://docs.docker.com/engine/release-notes/26.1/#2611) - [Wasm](/desktop/features/wasm/) runtimes: - Updated `runwasi` shims to `v0.4.0` - Updated `deislabs` shims to `v0.11.1` - Updated `spin` shim to `v0.13.1` - [Docker Scout CLI v1.8.0](https://github.com/docker/scout-cli/releases/tag/v1.8.0) - Docker Debug `v0.0.29` - Linux kernel `v6.6.26` - [Go 1.22.2](https://github.com/golang/go/releases/tag/go1.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 with `Unexpected 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](https://github.com/docker/for-mac/issues/7241). - Fixed a bug where high-throughput port forward transfers could stall. Fixes [docker/for-mac#7207](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/6824). - Enabled `CONFIG_SECURITY=y` kernel config, for example for [Tetragon](https://tetragon.io/). Fixes [docker/for-mac#7250](https://github.com/docker/for-mac/issues/7250). - Re-added support for `SQUASHFS` compression. Fixes [docker/for-mac#7260](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/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 unregister `docker-desktop` distribution if that was created, using `wsl --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](https://ubuntu.com/blog/ubuntu-23-10-restricted-unprivileged-user-namespaces) for more details. ## 4.29.0 2024-04-08 ### New - You can now enforce Rosetta usage via [Settings Management](/desktop/enterprise/hardened-desktop/settings-management/). - [Docker socket mount restrictions](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/config/) with ECI is now generally available. - Docker Engine and CLI updated to [Moby 26.0](https://github.com/moby/moby/releases/tag/v26.0.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)](/desktop/features/synchronized-file-sharing/). - New [interactive Compose CLI (experimental)](/compose/how-tos/environment-variables/envvars/#compose_menu). - Beta release of: - Air-Gapped Containers with [Settings Management](/desktop/enterprise/hardened-desktop/air-gapped-containers/). - [Host networking](/engine/network/drivers/host/#docker-desktop) in Docker Desktop. - [Docker Debug](/desktop/release-notes/use-desktop/container/#integrated-terminal) for running containers. - [Volumes Backup & Share extension](/desktop/release-notes/use-desktop/volumes/) functionality available in the **Volumes** tab. ### Upgrades - [Docker Compose v2.26.1](https://github.com/docker/compose/releases/tag/v2.26.1) - [Docker Scout CLI v1.6.3](https://github.com/docker/scout-cli/releases/tag/v1.6.3) - [Docker Engine v26.0.0](https://docs.docker.com/engine/release-notes/26.0/#2600) - [Buildx v0.13.1](https://github.com/docker/buildx/releases/tag/v0.13.1) - [Kubernetes v1.29.2](https://github.com/kubernetes/kubernetes/releases/tag/v1.29.2) - [cri-dockerd v0.3.11](https://github.com/Mirantis/cri-dockerd/releases/tag/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](https://github.com/docker/for-mac/issues/7171). - Removed non-official Docker image used for Rust cross-compilation. - The maximum number of files per [Synchronized file share](/desktop/features/synchronized-file-sharing/) 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 Desktop 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](https://github.com/docker/roadmap/issues/238). - Added a timestamp to new unread notifications. - Fixed typo in the virtualization support error message. Fixes [docker/desktop-linux#197](https://github.com/docker/desktop-linux/issues/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](https://github.com/docker/for-mac/issues/7136) and [docker/for-mac#7031](https://github.com/docker/for-mac/issues/7031). - Fixed a bug when the browser was not able to send back authentication information to Docker Desktop. Fixes [docker/for-mac/issues#7160](https://github.com/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 distributions (`docker-desktop` and `docker-desktop-data`) when it was shutdown. Fixes [docker/for-win/issues/13443](https://github.com/docker/for-win/issues/13443) and [docker/for-win/issues/13938](https://github.com/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.](https://www.electronjs.org/blog/statement-run-as-node-cves). - Fixed [CVE-2024-6222](https://cve.mitre.org/cgi-bin/cvename.cgi?name=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](https://github.com/docker/for-mac/issues/7243). ## 4.28.0 2024-02-26 ### New - [Settings Management](/desktop/enterprise/hardened-desktop/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 the [`SOCKS` proxy support beta feature](/desktop/features/networking/) is enabled. - Users can now filter volumes to see which ones are in use in the **Volumes** tab. ### Upgrades - [Compose v2.24.6](https://github.com/docker/compose/releases/tag/v2.24.6) - [Docker Engine v25.0.3](https://docs.docker.com/engine/release-notes/25.0/#2503) - [Docker Scout CLI v1.5.0](https://github.com/docker/scout-cli/releases/tag/v1.5.0) - [Qemu 8.1.5](https://wiki.qemu.org/ChangeLog/8.1) - [Wasm](/desktop/features/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` - Updated deislabs shims to `v0.11.1`, including: - lunatic `v0.13.2` - slight `v0.5.1` - spin `v2.2.0` - wws `v1.7.0` ### Bug fixes and enhancements #### For all platforms - Fixed `postgis` with `Qemu`. Fixes [docker/for-mac#7172](https://github.com/docker/for-mac/issues/7172). - Re added `CONFIG_BLK_DEV_DM` kernel config for `kpartx`. Fixes [docker/for-mac#7197](https://github.com/docker/for-mac/issues/7197). - Allow `SOCKS` proxies to be set via a proxy autoconfig `pac file`. - Re added `CONFIG_AUDIT` kernel config. - Fixed a bug with the Rust build on `virtiofs`. See [rust-lang/docker-rust#161](https://github.com/rust-lang/docker-rust/issues/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](https://github.com/docker/for-win/issues/13885), [docker/for-win#13896](https://github.com/docker/for-win/issues/13896), [docker/for-win#13899](https://github.com/docker/for-win/issues/13899), [docker/for-mac#7164](https://github.com/docker/for-mac/issues/7164), [docker/for-mac#7169](https://github.com/docker/for-mac/issues/7169) - Docker Init: - Improved how Java applications are started based on Spring Boot version. Fixes [docker/for-mac#7171](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/7182) - Fixed a bug that caused a crash on the `virtualization.framework`. Fixes [docker/for-mac#7024](https://github.com/docker/for-mac/issues/7024) #### For Windows - Fixed an issue with DNS timeouts on Windows. - Added support for Enhanced Container Isolation Docker socket mount permission on WSL user distributions. - 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](https://github.com/docker/for-win/issues/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 2024-02-08 ### Upgrades - [Compose v2.24.5](https://github.com/docker/compose/releases/tag/v2.24.5) - [Docker Scout CLI v1.4.1](https://github.com/docker/scout-cli/releases/tag/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](https://github.com/docker/for-win/issues/13887). - Fixed a bug in the build backend service that caused Docker Desktop to crash. Fixes [docker/for-win#13885](https://github.com/docker/for-win/issues/13885), [docker/for-win#13896](https://github.com/docker/for-win/issues/13896), [docker/for-win#13899](https://github.com/docker/for-win/issues/13899), [docker/for-mac#7164](https://github.com/docker/for-mac/issues/7164), [docker/for-mac#7169](https://github.com/docker/for-mac/issues/7169). - Fixed the Docker Engine socket permissions when mounted inside containers. Fixes [docker/for-win#13898](https://github.com/docker/for-win/issues/13898). - Docker Scout: - Updated dependencies to address Leaky Vessels series of CVEs ([CVE-2024-21626](https://github.com/advisories/GHSA-xr7r-f8xq-vfvv), [CVE-2024-24557](https://github.com/advisories/GHSA-xw73-rw38-6vjc)) - Added initial VEX document to document false positive [CVE-2020-8911](https://github.com/advisories/GHSA-f5pg-7wfw-84q9) and [CVE-2020-8912](https://github.com/advisories/GHSA-7f33-f4f5-xwgw) - 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](https://github.com/docker/for-mac/issues/7148). - Node now uses all the cores available under Rosetta. - Fixed an issue with `php-fpm`. Fixes [docker/for-mac#7037](https://github.com/docker/for-mac/issues/7037). ## 4.27.1 2024-02-01 ### Upgrades - [Docker Engine v25.0.2](https://docs.docker.com/engine/release-notes/25.0/#2502) which contains a fix for [CVE-2024-24557](https://scout.docker.com/vulnerabilities/id/CVE-2024-24557), [CVE-2024-23650](https://scout.docker.com/vulnerabilities/id/CVE-2024-23650), [CVE-2024-23651](https://scout.docker.com/vulnerabilities/id/CVE-2024-23651), [CVE-2024-23652](https://scout.docker.com/vulnerabilities/id/CVE-2024-23652) and [CVE-2024-23653](https://scout.docker.com/vulnerabilities/id/CVE-2024-23653) - [Containerd v1.6.28](https://github.com/containerd/containerd/releases/tag/v1.6.28) - [Runc v1.1.12](https://github.com/opencontainers/runc/releases/tag/v1.1.12) which contains a fix for [CVE-2024-21626](https://scout.docker.com/vulnerabilities/id/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 2024-01-25 ### New - Docker init now supports Java and is generally available to all users. - [Synchronized File Shares](/desktop/features/synchronized-file-sharing/) provides fast and flexible host-to-VM file sharing within Docker Desktop. Utilizing the technology behind [Docker’s acquisition of Mutagen](https://www.docker.com/blog/mutagen-acquisition/), 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](/desktop/enterprise/hardened-desktop/enhanced-container-isolation/config/) when ECI is enabled. - [Containerd Image Store](/desktop/features/containerd/) support is now generally available to all users. - Get a debug shell into any container or image with the new [`docker debug` command](/reference/cli/docker/debug/) (Beta). - Organization admins, with a Docker Business subscription, can now configure a custom list of extensions with [Private Extensions Marketplace](/extensions/private-marketplace/) enabled (Beta) ### Upgrades - [Amazon ECR Credential Helper v0.7.1](https://github.com/awslabs/amazon-ecr-credential-helper/releases/tag/v0.7.1) - [Buildx v0.12.1](https://github.com/docker/buildx/releases/tag/v0.12.1) - [Containerd v1.6.27](https://github.com/containerd/containerd/releases/tag/v1.6.27) - [Compose v2.24.3](https://github.com/docker/compose/releases/tag/v2.24.3) - [Docker Credential Helpers v0.8.1](https://github.com/docker/docker-credential-helpers/releases/tag/v0.8.1) - [Runc v1.1.11](https://github.com/opencontainers/runc/releases/tag/v1.1.11) - [Docker Engine v25.0.0](https://docs.docker.com/engine/release-notes/25.0/) - [Kubernetes v1.29.1](https://github.com/kubernetes/kubernetes/releases/tag/v1.29.1) - [Docker Scout v1.3.0](https://github.com/docker/scout-cli/releases/tag/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 the [`docker scout` command](/reference/cli/docker/scout/). - 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](https://github.com/docker/for-mac/issues/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` and `autofs`. - 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](https://github.com/docker/for-mac/issues/7117). - Fixed `xvfb` under Rosetta. Fixes [docker/for-mac#7122](https://github.com/docker/for-mac/issues/7122) - Fixed `ERR_WORKER_INVALID_EXEC_ARGV` error under Rosetta. [docker/for-mac#6998](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/13868). - Fixed a bug where the credentials store configuration would reset on app restart with the WSL integration. Fixes [docker/for-win#13529](https://github.com/docker/for-win/issues/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](https://github.com/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 2023-12-14 ### 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](https://github.com/docker/for-win/issues/13824) ## 4.26.0 2023-12-04 ### New - Administrators can now control access to beta and experimental features in the **Features in development** tab with [Settings Management](/desktop/enterprise/hardened-desktop/settings-management/). - Introduced four new version update states in the footer. - `docker init` (Beta) now supports PHP with Apache + Composer. - The [**Builds** view](/desktop/release-notes/use-desktop/builds/) is now GA. You can now inspect builds, troubleshoot errors, and optimize build speed. ### Upgrades - [Compose v2.23.3](https://github.com/docker/compose/releases/tag/v2.23.3) - [Docker Scout CLI v1.2.0](https://github.com/docker/scout-cli/releases/tag/v1.2.0). - [Buildx v0.12.0](https://github.com/docker/buildx/releases/tag/v0.12.0) - [Wasm](/desktop/features/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](https://docs.docker.com/engine/release-notes/24.0/#2407) - [Containerd v1.6.25](https://github.com/containerd/containerd/releases/tag/v1.6.25) - [runc v1.1.10](https://github.com/opencontainers/runc/releases/tag/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 where `ServerAddress` 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 to `docker pull` (pull all remote repository tags). - Added support for `--group-add` flag to `docker 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](https://github.com/docker/for-mac/issues/6773) and [docker/for-mac#7037](https://github.com/docker/for-mac/issues/7037). - Fixed several issues related to Rosetta not working. Fixed [[docker/for-mac#6973](https://github.com/docker/for-mac/issues/6973), [[docker/for-mac#7009](https://github.com/docker/for-mac/issues/7009), [[docker/for-mac#7068](https://github.com/docker/for-mac/issues/7068) and [[docker/for-mac#7075](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/7052). - You can now enable the use of Kernel networking path for UDP through the UI. Fixes [docker/for-mac#7008](https://github.com/docker/for-mac/issues/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 than `2.32`. This will be fixed in future releases. See [docker/for-win#13824](https://github.com/docker/for-win/issues/13824). ## 4.25.2 2023-11-21 ### 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](https://github.com/docker/for-win/issues/13789) ## 4.25.1 2023-11-13 ### 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](https://github.com/docker/for-mac/issues/7045), [docker/for-mac#7044](https://github.com/docker/for-mac/issues/7044) and [docker/for-win#13779](https://github.com/docker/for-win/issues/13779). - The `sysctl vm.max_map_count` is now set to 262144. See [docker/for-mac#7047](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/13761). - Fixed a bug where the WSL integration would not work for users using a shell other than `sh`. See [docker/for-win#13764](https://github.com/docker/for-win/issues/13764). - Re-added `DockerCli.exe`. ## 4.25.0 2023-10-26 ### 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](/desktop/settings-and-maintenance/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](/desktop/enterprise/hardened-desktop/settings-management/). ### Upgrades - [Compose v2.23.0](https://github.com/docker/compose/releases/tag/v2.23.0) - [Docker Scout CLI v1.0.9](https://github.com/docker/scout-cli/releases/tag/v1.0.9). - [Kubernetes v1.28.2](https://github.com/kubernetes/kubernetes/releases/tag/v1.28.2) - [cri-dockerd v0.3.4](https://github.com/Mirantis/cri-dockerd/releases/tag/v0.3.4) - [CNI plugins v1.3.0](https://github.com/containernetworking/plugins/releases/tag/v1.3.0) - [cri-tools v1.28.0](https://github.com/kubernetes-sigs/cri-tools/releases/tag/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 supports `Layer already exists` and `Mounted 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](https://docs.docker.com/desktop/use-desktop/resource-saver/) 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](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/13715) #### For Linux - Fixed a bug in `docker login`. Fixes [docker/docker-credential-helpers#299](https://github.com/docker/docker-credential-helpers/issues/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](https://docs.docker.com/desktop/uninstall/). #### 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](/desktop/settings-and-maintenance/settings/) 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 2023-10-12 ### 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](https://github.com/docker/for-win/issues/13722). - Fixed a performance regression for PyTorch. ## 4.24.1 2023-10-04 ### Bug fixes and enhancements #### For Windows - Fixed a bug on Docker Desktop for Windows where the Docker Desktop Dashboard wouldn't display container logs correctly. Fixes [docker/for-win#13714](https://github.com/docker/for-win/issues/13714). ## 4.24.0 2023-09-28 ### 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 Desktop Dashboard to access the notification center. - Compose Watch is now available to all users. For more information, see [Use Compose Watch](/compose/how-tos/file-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](/desktop/release-notes/use-desktop/resource-saver/). - You can now view and manage the Docker Engine state, with pause, stop, and resume, directly from the Docker Desktop Dashboard. ### Upgrades - [Compose v2.22.0](https://github.com/docker/compose/releases/tag/v2.22.0) - [Go 1.21.1](https://github.com/golang/go/releases/tag/go1.21.1) - [Wasm](/desktop/features/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](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/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 earlier than 12.5. Fixes [docker/for-mac#6975](https://github.com/docker/for-mac/issues/6975). - Fixed a bug where Docker Desktop failed to start if invalid directories were included in `filesharingDirectories`. Fixes [docker/for-mac#6980](https://github.com/docker/for-mac/issues/6980). - Fixed a bug where installer is creating root-owned directories. Fixes [docker/for-mac#6984](https://github.com/docker/for-mac/issues/6984). - Fixed a bug where installer is failing on setting up the docker socket when missing `/Library/LaunchDaemons`. Fixes [docker/for-mac#6967](https://github.com/docker/for-mac/issues/6967). - Fixed a permission denied error when binding a privileged port to a non-localhost IP on macOS. Fixes [docker/for-mac#697](https://github.com/docker/for-mac/issues/6977). - Fixed a resource leak introduced in 4.23. Related to [docker/for-mac#6953](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/13679). - Fixed a bug that caused Docker Desktop fail to start on Windows hosts. Fixes [docker/for-win#13662](https://github.com/docker/for-win/issues/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 the `settings.json` file located at `~/Library/Group Containers/group.com.docker/settings.json`. ## 4.23.0 2023-09-11 ### Upgrades - [Compose v2.21.0](https://github.com/docker/compose/releases/tag/v2.21.0) - [Docker Engine v24.0.6](https://docs.docker.com/engine/release-notes/24.0/#2406) - [Docker Scout CLI v0.24.1](https://github.com/docker/scout-cli/releases/tag/v0.24.1). - [Wasm](/desktop/features/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`](/reference/cli/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. ### Bug fixes and enhancements #### For all platforms - With [Docker Scout](/desktop/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 Desktop 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` and `MAINTAINER` 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](https://github.com/docker/desktop-linux/issues/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](https://www.cve.org/cverecord?id=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](https://www.cve.org/cverecord?id=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 (using `127.0.0.1`). ## 4.22.1 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](https://github.com/docker/for-mac/issues/6933) #### For Windows - Fixed `Clean / Purge data` troubleshoot option on Windows. [docker/for-win#13630](https://github.com/docker/for-win/issues/13630) ## 4.22.0 2023-08-03 ### Upgrades - [Buildx v0.11.2](https://github.com/docker/buildx/releases/tag/v0.11.2) - [Compose v2.20.2](https://github.com/docker/compose/releases/tag/v2.20.2) - [Docker Engine v24.0.5](https://docs.docker.com/engine/release-notes/24.0/#2405) > [!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` outputs `buildx v0.11.2-desktop.1`. ### New - [Resource Usage](/desktop/release-notes/use-desktop/container/) has moved from experimental to GA. - You can now split large Compose projects into multiple sub-projects with [`include`](/compose/how-tos/multiple-compose-files/include/). ### Bug fixes and enhancements #### For all platforms - [Settings Management](/desktop/enterprise/hardened-desktop/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](/desktop/release-notes/use-desktop/container/). - You can now download Wasm runtimes when the containerd image store is enabled. - With [Quick Search](/desktop/use-desktop/#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](https://github.com/docker/for-mac/issues/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](/desktop/settings-and-maintenance/settings/) 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](https://github.com/docker/for-win/issues/13479). - Fixed a bug where an invalid regular expression in the search bar caused an error. Fixes [docker/for-win#13592](https://github.com/docker/for-win/issues/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](/desktop/settings-and-maintenance/settings/) in settings. ## 4.21.1 2023-07-03 #### For all platforms - Fixed connection leak for Docker contexts using SSH ([docker/for-mac#6834](https://github.com/docker/for-mac/issues/6834) and [docker/for-win#13564](https://github.com/docker/for-win/issues/13564)) #### For Mac - Removed configuration health check for further investigation and addressing specific setups. ## 4.21.0 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](/desktop/release-notes/use-desktop/builds/) 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](https://github.com/docker/buildx/releases/tag/v0.11.0) - [Compose v2.19.0](https://github.com/docker/compose/releases/tag/v2.19.0) - [Kubernetes v1.27.2](https://github.com/kubernetes/kubernetes/releases/tag/v1.27.2) - [cri-tools v1.27.0](https://github.com/kubernetes-sigs/cri-tools/releases/tag/v1.27.0) - [cri-dockerd v0.3.2](https://github.com/Mirantis/cri-dockerd/releases/tag/v0.3.2) - [coredns v1.10.1](https://github.com/coredns/coredns/releases/tag/v1.10.1) - [cni v1.2.0](https://github.com/containernetworking/plugins/releases/tag/v1.2.0) - [etcd v3.5.7](https://github.com/etcd-io/etcd/releases/tag/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](https://github.com/docker/for-win/issues/13447) and [docker/for-mac#6823](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/6814). - Fixed a bug which caused input labels to overlap with input values on the container run dialog. Fixes [docker/for-win#13304](https://github.com/docker/for-win/issues/13304). - Fixed a bug which meant users couldn't select the Docker Extension menu. Fixes [docker/for-mac#6840](https://github.com/docker/for-mac/issues/6840) and [docker/for-mac#6855](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/13547). - Fixed the WSL engine's ability to detect cases where one of the Docker Desktop distributions' drive is missing [docker/for-win#13554](https://github.com/docker/for-win/issues/13554). - A slow or unresponsive WSL integration no longer prevents Docker Desktop from starting. Fixes [docker/for-win#13549](https://github.com/docker/for-win/issues/13549). - Fixed a bug that caused Docker Desktop to crash on startup [docker/for-win#6890](https://github.com/docker/for-mac/issues/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 distribution disks. ## 4.20.1 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](https://github.com/docker/for-win/issues/13518) and [docker/for-win#13524](https://github.com/docker/for-win/issues/13524). ## 4.20.0 2023-05-30 ### Upgrades - [Buildx v0.10.5](https://github.com/docker/buildx/releases/tag/v0.10.5) - [Compose v2.18.1](https://github.com/docker/compose/releases/tag/v2.18.1) - [Docker Engine v24.0.2](https://docs.docker.com/engine/release-notes/24.0/#2402) - [Containerd v1.6.21](https://github.com/containerd/containerd/releases/tag/v1.6.21) - [runc v1.1.7](https://github.com/opencontainers/runc/releases/tag/v1.1.5) ### Bug fixes and enhancements #### For all platforms - [Docker Scout CLI](https://docs.docker.com/scout/#docker-scout-cli) now finds the most recently built image if it is not provided as an argument. - Improved the [Docker Scout CLI](https://docs.docker.com/scout/#docker-scout-cli) `compare` command. - Added a warning about the [retirement of Docker Compose ECS/ACS integrations in November 2023](https://docs.docker.com/go/compose-ecs-eol/). 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](https://github.com/docker/for-mac/issues/371). - Fixed a bug that prevented containers accessing 169.254.0.0/16 IPs. Fixes [docker/for-mac#6825](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/6825). #### For Windows - Fixed a bug that meant WSL data could not be moved to a different disk. Fixes [docker/for-win#13269](https://github.com/docker/for-win/issues/13269). - Fixed a bug where Docker Desktop was not stopping its WSL distributions (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](/desktop/settings-and-maintenance/settings/#proxies). #### For Linux - Fixed an issue with the Docker Compose V1/V2 compatibility setting. ## 4.19.0 2023-04-27 ### New - Docker Engine and CLI updated to [Moby 23.0](https://github.com/moby/moby/releases/tag/v23.0.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 new `docker scout` command. Run `docker scout --help`, or [read the docs to learn more](/reference/cli/docker/scout/). ### Upgrades - [Docker Engine v23.0.5](https://docs.docker.com/engine/release-notes/23.0/#2305) - [Compose 2.17.3](https://github.com/docker/compose/releases/tag/v2.17.3) - [Containerd v1.6.20](https://github.com/containerd/containerd/releases/tag/v1.6.20) - [Kubernetes v1.25.9](https://github.com/kubernetes/kubernetes/releases/tag/v1.25.9) - [runc v1.1.5](https://github.com/opencontainers/runc/releases/tag/v1.1.5) - [Go v1.20.3](https://github.com/golang/go/releases/tag/go1.20.3) ### Bug fixes and enhancements #### For all platforms - Improved `docker scout compare` command to compare two images, now also aliased under `docker scout diff`. - Added more details to dashboard errors when a `docker-compose` action fails ([docker/for-win#13378](https://github.com/docker/for-win/issues/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](/desktop/setup/install/mac-install/#install-from-the-command-line) and [Windows](/desktop/setup/install/windows-install/#install-from-the-command-line), or alternatively by setting the values in the `install-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 CLI `docker login` and `docker 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` or `false`. 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` and `gateway.docker.internal` again). For WSL, this behavior is controlled by a new setting in the **General** tab. Fixes [docker/for-win#13388](https://github.com/docker/for-win/issues/13388) and [docker/for-win#13398](https://github.com/docker/for-win/issues/13398). - Fixed a spurious `courgette.log` file appearing on the Desktop when updating Docker Desktop. Fixes [docker/for-win#12468](https://github.com/docker/for-win/issues/12468). - Fixed the "zoom in" shortcut (ctrl+=). Fixes [docker/for-win#13392](https://github.com/docker/for-win/issues/13392). - Fixed a bug where the tray menu would not correctly update after second container type switch. Fixes [docker/for-win#13379](https://github.com/docker/for-win/issues/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 your `settings.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](https://github.com/docker/for-mac/issues/6801). - Fixed cases where `docker pull` would return `EOF`. #### For Linux - Fixed a bug where the VM networking crashes after 24h. Fixes [docker/desktop-linux#131](https://github.com/docker/desktop-linux/issues/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 the `credsStore` key from their Docker CLI configuration file. Only affects Docker Business customers. - Fixed [CVE-2023-24532](https://github.com/advisories/GHSA-x2w5-7wp4-5qff). - Fixed [CVE-2023-25809](https://github.com/advisories/GHSA-m8cg-xc2p-r3fc). - Fixed [CVE-2023-27561](https://github.com/advisories/GHSA-vpvm-3wq2-2wvm). - Fixed [CVE-2023-28642](https://github.com/advisories/GHSA-g2j6-57v7-gm8c). - Fixed [CVE-2023-28840](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2023-28840). - Fixed [CVE-2023-28841](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2023-28841). - Fixed [CVE-2023-28842](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2023-28842). ## 4.18.0 2023-04-03 ### New - Initial beta release of `docker init` as per [the roadmap](https://github.com/docker/roadmap/issues/453). - 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](https://github.com/docker/buildx/releases/tag/v0.10.4) - [Compose 2.17.2](https://github.com/docker/compose/releases/tag/v2.17.2) - [Containerd v1.6.18](https://github.com/containerd/containerd/releases/tag/v1.6.18), which includes fixes for [CVE-2023-25153](https://github.com/advisories/GHSA-259w-8hf6-59c2) and [CVE-2023-25173](https://github.com/advisories/GHSA-hmfx-3pcx-653p). - [Docker Engine v20.10.24](https://docs.docker.com/engine/release-notes/20.10/#201024), which contains fixes for [CVE-2023-28841](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2023-28841), [CVE-2023-28840](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2023-28840), and [CVE-2023-28842](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2023-28842). ### Bug fixes and enhancements #### For all platforms - [Docker Scout CLI](/desktop/scout/#docker-scout-cli) can now compare two images and display packages and vulnerabilities differences. This command is in [Early Access](/desktop/release-lifecycle/) and might change in the future. - [Docker Scout CLI](/desktop/scout/#docker-scout-cli) now displays base image update and remediation recommendations using `docker scout recommendations`. It also displays a short overview of an image using `docker 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](https://github.com/docker/for-win/issues/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](/desktop/setup/install/windows-permission-requirements/). ### 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](https://docs.docker.com/desktop/mac/permission-requirements/). - 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](https://github.com/docker/desktop-linux/issues/131) ### Security #### For all platforms - Fixed [CVE-2023-1802](https://www.cve.org/cverecord?id=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](https://github.com/docker/for-win/issues/13344). #### For Mac - Removed the `com.apple.security.cs.allow-dyld-environment-variables` and `com.apple.security.cs.disable-library-validation` entitlements which allow an arbitrary dynamic library to be loaded with Docker Desktop via the `DYLD_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 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](https://github.com/docker/for-win/issues/13324). ## 4.17.0 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](/desktop/scout/). - `docker scan` has been replaced by `docker scout`. See [Docker Scout CLI](/desktop/scout/#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](/extensions/marketplace/). - **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](https://github.com/containerd/containerd/releases/tag/v1.6.18), which includes fixes for [CVE-2023-25153](https://github.com/advisories/GHSA-259w-8hf6-59c2) and [CVE-2023-25173](https://github.com/advisories/GHSA-hmfx-3pcx-653p). - [Docker Engine v20.10.23](https://docs.docker.com/engine/release-notes/20.10/#201023). - [Go 1.19.5](https://github.com/golang/go/releases/tag/go1.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](https://github.com/tailscale/docker-extension/issues/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 is `Info.plist`. Fixes [docker/for-mac#6677](https://github.com/docker/for-mac/issues/6677). - Fixed a bug where user is prompted to create the docker socket symlink on every startup. Fixes [docker/for-mac#6634](https://github.com/docker/for-mac/issues/6634). - Fixed a bug that caused the **Start Docker Desktop when you log in** setting not to work. Fixes [docker/for-mac#6723](https://github.com/docker/for-mac/issues/6723). - Fixed UDP connection tracking and `host.docker.internal`. Fixes [docker/for-mac#6699](https://github.com/docker/for-mac/issues/6699). - Improved kubectl symlink logic to respect existing binaries in `/usr/local/bin`. Fixes [docker/for-mac#6328](https://github.com/docker/for-mac/issues/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 install `alpine-pkg-glibc` in user distributions. - 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 distributions) 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](https://github.com/docker/for-win/issues/10247). - Fixed an issue that caused WSL integration agents to be terminated erroneously. Related to [docker/for-win#13202](https://github.com/docker/for-win/issues/13202). - Fixed corrupt contexts on start. Fixes [docker/for-win#13180](https://github.com/docker/for-win/issues/13180) and [docker/for-win#12561](https://github.com/docker/for-win/issues/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](https://github.com/docker/desktop-linux/issues/123). ### Security #### For all platforms - Fixed [CVE-2023-0628](https://www.cve.org/cverecord?id=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](https://www.cve.org/cverecord?id=CVE-2023-0629), which allows an unprivileged user to bypass Enhanced Container Isolation (ECI) restrictions by setting the Docker host to `docker.raw.sock`, or `npipe:////.pipe/docker_engine_linux` on Windows, via the `-H` (`--host`) CLI flag or the `DOCKER_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 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](https://github.com/docker/for-win/issues/13184). - Fixed Docker Desktop failing to report a missing or outdated WSL installation when starting. Fixes [docker/for-win#13184](https://github.com/docker/for-win/issues/13184). ## 4.16.2 2023-01-19 ### Bug fixes and enhancements #### For all platforms - Fixed an issue where `docker build` and `docker tag` commands produced an `image 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](https://github.com/docker/for-mac/issues/6689). #### For Mac - Fixed the capitalization of `Info.plist` which caused `vmnetd` to break on case-sensitive file systems. Fixes [docker/for-mac/6677](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/13165) ## 4.16.1 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](https://github.com/docker/for-mac/issues/6675) and [docker/for-win/13161](https://github.com/docker/for-win/issues/13161). ## 4.16.0 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](https://github.com/docker/compose/releases/tag/v2.15.1) - [Containerd v1.6.14](https://github.com/containerd/containerd/releases/tag/v1.6.14) - [Docker Engine v20.10.22](https://docs.docker.com/engine/release-notes/20.10/#201022) - [Buildx v0.10.0](https://github.com/docker/buildx/releases/tag/v0.10.0) - [Docker Scan v0.23.0](https://github.com/docker/scan-cli-plugin/releases/tag/v0.23.0) - [Go 1.19.4](https://github.com/golang/go/releases/tag/go1.19.4) ### Bug fixes and enhancements #### For all platforms - Fixed `docker build --quiet` not outputting the image identifier with the `containerd` 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](https://github.com/docker/for-mac/issues/6566). - Fixed the Docker Desktop 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](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/6614). - Added back a way to uninstall Docker Desktop from the command line. Fixes [docker/for-mac#6598](https://github.com/docker/for-mac/issues/6598). - Fixed hardcoded `/usr/bin/kill`. Fixes [docker/for-mac#6589](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/10247). - Fixed typo in diagnose.exe output Fixes [docker/for-win#13107](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-mac/issues/6675) and [docker/for-win/13161](https://github.com/docker/for-win/issues/13161). ## 4.15.0 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](https://docs.docker.com/desktop/mac/permission-requirements/). - Added [WebAssembly capabilities](/desktop/features/wasm/). Use with the [containerd integration](/desktop/features/containerd/). - 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 Desktop 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 - [Compose v2.13.0](https://github.com/docker/compose/releases/tag/v2.13.0) - [Containerd v1.6.10](https://github.com/containerd/containerd/releases/tag/v1.6.10) - [Docker Hub Tool v0.4.5](https://github.com/docker/hub-tool/releases/tag/v0.4.5) - [Docker Scan v0.22.0](https://github.com/docker/scan-cli-plugin/releases/tag/v0.22.0) ### 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](https://github.com/docker/for-win/issues/13053), [docker/for-mac#6560](https://github.com/docker/for-mac/issues/6560), and [docker/for-mac#6540](https://github.com/docker/for-mac/issues/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](https://github.com/docker/desktop-linux/issues/30). - Disabled tray icon animations on Linux which fixes crashes for some users. ## 4.14.1 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](https://github.com/docker/for-mac/issues/6569) ## 4.14.0 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](/engine/release-notes/20.10/#201021), which contains mitigations against a Git vulnerability, tracked in [CVE-2022-39253](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2022-39253), and updates the handling of `image:tag@digest` image references. - [Docker Compose v2.12.2](https://github.com/docker/compose/releases/tag/v2.12.2) - [Containerd v1.6.9](https://github.com/containerd/containerd/releases/tag/v1.6.9) - [Go 1.19.3](https://github.com/golang/go/releases/tag/go1.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](https://github.com/docker/for-win/issues/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](https://www.electronjs.org/docs/latest/tutorial/context-isolation) and [sandbox](https://www.electronjs.org/docs/latest/tutorial/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](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](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 like `tilt` and `docker-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](https://github.com/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 2022-10-31 ### Updates - [Docker Compose v2.12.1](https://github.com/docker/compose/releases/tag/v2.12.1) ### Bug fixes and enhancements #### For all platforms - Fixed a possible segfault when interrupting `docker pull` with `Control+C` or `CMD+C`. - Increased the default DHCP lease time to avoid the VM's network glitching and dropping connections every two hours. - Reverted `Qemu` to `6.2.0` to fix errors like `PR_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 like `tilt` and `docker-py`. Fixes [docker/for-mac#6529](https://github.com/docker/for-mac/issues/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 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](/desktop/enterprise/hardened-desktop/). - 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](https://github.com/docker/roadmap/issues/94). ### Updates - [Docker Scan v0.21.0](https://github.com/docker/scan-cli-plugin/releases/tag/v0.21.0) - [Go 1.19.2](https://github.com/golang/go/releases/tag/go1.19.2) to address [CVE-2022-2879](https://www.cve.org/CVERecord?id=CVE-2022-2879), [CVE-2022-2880](https://www.cve.org/CVERecord?id=CVE-2022-2880) and [CVE-2022-41715](https://www.cve.org/CVERecord?id=CVE-2022-41715) - Updated Docker Engine and Docker CLI to [v20.10.20](/engine/release-notes/20.10/#201020), which contain mitigations against a Git vulnerability, tracked in [CVE-2022-39253](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2022-39253), and updated handling of `image:tag@digest` image references, as well as a fix for [CVE-2022-36109](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2022-36109). - [Docker Credential Helpers v0.7.0](https://github.com/docker/docker-credential-helpers/releases/tag/v0.7.0) - [Docker Compose v2.12.0](https://github.com/docker/compose/releases/tag/v2.12.0) - [Kubernetes v1.25.2](https://github.com/kubernetes/kubernetes/releases/tag/v1.25.2) - [Qemu 7.0.0](https://wiki.qemu.org/ChangeLog/7.0) used for cpu emulation, inside the Docker Desktop VM. - [Linux kernel 5.15.49](https://hub.docker.com/layers/docker/for-desktop-kernel/5.15.49-13422a825f833d125942948cf8a8688cef721ead/images/sha256-ebf1f6f0cb58c70eaa260e9d55df7c43968874d62daced966ef6a5c5cd96b493?context=explore) ### 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](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/10247), [docker/for-win#12995](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/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 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](https://github.com/docker/for-mac/issues/6425). - Added search capabilities to Docker Extension's Marketplace. Fixes [docker/roadmap#346](https://github.com/docker/roadmap/issues/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](https://github.com/docker/compose/releases/tag/v2.10.2) - [Docker Scan v0.19.0](https://github.com/docker/scan-cli-plugin/releases/tag/v0.19.0) - [Kubernetes v1.25.0](https://github.com/kubernetes/kubernetes/releases/tag/v1.25.0) - [Go 1.19](https://github.com/golang/go/releases/tag/go1.19) - [cri-dockerd v0.2.5](https://github.com/Mirantis/cri-dockerd/releases/tag/v0.2.5) - [Buildx v0.9.1](https://github.com/docker/buildx/releases/tag/v0.9.1) - [containerd v1.6.8](https://github.com/containerd/containerd/releases/tag/v1.6.8) - [containerd v1.6.7](https://github.com/containerd/containerd/releases/tag/v1.6.7) - [runc v1.1.4](https://github.com/opencontainers/runc/releases/tag/v1.1.4) - [runc v1.1.3](https://github.com/opencontainers/runc/releases/tag/v1.1.3) ### Security #### For all platforms - Fixed [CVE-2023-0626](https://www.cve.org/cverecord?id=CVE-2023-0626) which allows RCE via query parameters in the message-box route in the Electron client. - Fixed [CVE-2023-0625](https://www.cve.org/cverecord?id=CVE-2023-0625) which allows RCE via extension description/changelog which could be abused by a malicious extension. #### For Windows - Fixed [CVE-2023-0627](https://www.cve.org/cverecord?id=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](https://www.cve.org/cverecord?id=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](/compose/how-tos/environment-variables/envvars-precedence/). - Upgraded kernel to 5.10.124. - Improved overall performance issues caused by calculating disk size. Related to [docker/for-win#9401](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-win/issues/12693) and [docker/for-mac#6347](https://github.com/docker/for-mac/issues/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](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](https://github.com/docker/for-mac/issues/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](https://github.com/docker/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](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/12822). ## 4.11.1 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](https://github.com/docker/for-mac/issues/6433) #### For Windows - Fixed `docker login` to private registries from WSL2 distribution [docker/for-win#12871](https://github.com/docker/for-win/issues/12871) ## 4.11.0 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](/desktop/setup/vm-vdi/) - Added two new extensions ([vcluster](https://hub.docker.com/extensions/loftsh/vcluster-dd-extension) and [PGAdmin4](https://hub.docker.com/extensions/mochoa/pgadmin4-docker-extension)) 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](https://github.com/docker/for-win/issues/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 ` sets up Docker Desktop for a specific user, preventing them from needing an admin password on first run. ### Updates - [Docker Compose v2.7.0](https://github.com/docker/compose/releases/tag/v2.7.0) - [Docker Compose "Cloud Integrations" v1.0.28](https://github.com/docker/compose-cli/releases/tag/v1.0.28) - [Kubernetes v1.24.2](https://github.com/kubernetes/kubernetes/releases/tag/v1.24.2) - [Go 1.18.4](https://github.com/golang/go/releases/tag/go1.18.4) ### 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](https://github.com/docker/for-win/issues/12828). - Fixed an issue which caused infinite loading on the **Volume** screen [docker/for-win#12789](https://github.com/docker/for-win/issues/12789). - Fixed a problem in the Container UI where resizing or hiding columns didn't work. Fixes [docker/for-mac#6391](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-mac/issues/6400). #### For Windows - Fixed horizontal resizing issue. Fixes [docker/for-win#12816](https://github.com/docker/for-win/issues/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 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](https://github.com/docker/for-win/issues/12806). #### For Mac - Fixed a bug where the install command failed because paths were not initialized. Fixes [docker/for-mac#6384](https://github.com/docker/for-mac/issues/6384). ## 4.10.0 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](https://docs.google.com/forms/d/e/1FAIpQLSfYueBkJHdgxqsWcQn4VzBn2swu4u_rMQRIMa8LExYb_72mmQ/viewform?entry.1237514594=4.10). ### Updates - [Docker Engine v20.10.17](/engine/release-notes/20.10/#201017) - [Docker Compose v2.6.1](https://github.com/docker/compose/releases/tag/v2.6.1) - [Kubernetes v1.24.1](https://github.com/kubernetes/kubernetes/releases/tag/v1.24.1) - [cri-dockerd to v0.2.1](https://github.com/Mirantis/cri-dockerd/releases/tag/v0.2.1) - [CNI plugins to v1.1.1](https://github.com/containernetworking/plugins/releases/tag/v1.1.1) - [containerd to v1.6.6](https://github.com/containerd/containerd/releases/tag/v1.6.6) - [runc to v1.1.2](https://github.com/opencontainers/runc/releases/tag/v1.1.2) - [Go 1.18.3](https://github.com/golang/go/releases/tag/go1.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](https://github.com/docker/extensions-sdk/issues/162). - Fixed a bug where the image search field is cleared without a reason. Fixes [docker/for-win#12738](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-mac/issues/6366). #### For Mac - Fixed a bug with location of bash completion files on macOS. Fixes [docker/for-mac#6343](https://github.com/docker/for-mac/issues/6343). - Fixed a bug where Docker Desktop does not start if the username is longer than 25 characters. Fixes [docker/for-mac#6122](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/12780). - Fixed a bug where Docker Desktop for Windows would fail to start. Fixes [docker/for-win#12784](https://github.com/docker/for-win/issues/12784). - Fixed the `--backend=wsl-2` installer flag which did not set the backend to WSL 2. Fixes [docker/for-win#12746](https://github.com/docker/for-win/issues/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](https://github.com/moby/buildkit/pull/2177) in the version of buildkit used in the current engine and will be fixed in future releases. ## 4.9.1 2022-06-16

Download Docker Desktop

Windows (checksum) | Mac with Apple chip (checksum) | Mac with Intel chip (checksum) | Debian - RPM - Arch (checksum)

### Bug fixes and enhancements #### For all platforms - Fixed blank dashboard screen. Fixes [docker/for-win#12759](https://github.com/docker/for-win/issues/12759). ## 4.9.0 2022-06-02 ### New - Added additional guides on the homepage for: Elasticsearch, MariaDB, Memcached, MySQL, RabbitMQ and Ubuntu. - Added a footer to the Docker Desktop 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 - [Compose v2.6.0](https://github.com/docker/compose/releases/tag/v2.6.0) - [Docker Engine v20.10.16](/engine/release-notes/20.10/#201016) - [containerd v1.6.4](https://github.com/containerd/containerd/releases/tag/v1.6.4) - [runc v1.1.1](https://github.com/opencontainers/runc/releases/tag/v1.1.1) - [Go 1.18.2](https://github.com/golang/go/releases/tag/go1.18.2) ### 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 Desktop 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](https://github.com/docker/for-win/issues/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 2022-05-18 ### Updates - [Compose v2.5.1](https://github.com/docker/compose/releases/tag/v2.5.1) ### Bug fixes and minor enahancements - Fixed an issue with manual proxy settings which caused problems when pulling images. Fixes [docker/for-win#12714](https://github.com/docker/for-win/issues/12714) and [docker/for-mac#6315](https://github.com/docker/for-mac/issues/6315). - Fixed high CPU usage when extensions are disabled. Fixes [docker/for-mac#6310](https://github.com/docker/for-mac/issues/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 2022-05-09 ### New - Released [Docker Desktop for Linux](/desktop/setup/install/linux/). - Beta release of [Docker Extensions](/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](https://www.docker.com/blog/announcing-compose-v2-general-availability/) ### 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 2022-05-06 ### New - Released [Docker Desktop for Linux](/desktop/setup/install/linux/). - Beta release of [Docker Extensions](/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](https://www.docker.com/blog/announcing-compose-v2-general-availability/) ### Updates - [Compose v2.5.0](https://github.com/docker/compose/releases/tag/v2.5.0) - [Go 1.18.1](https://github.com/golang/go/releases/tag/go1.18.1) - [Kubernetes 1.24](https://github.com/kubernetes/kubernetes/releases/tag/v1.24.0) ### 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](https://github.com/docker/for-mac/issues/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 /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](https://github.com/docker/for-mac/issues/5536) - Fixed a problem with duplicate Dock icons and Dock icon not working as expected. Fixes [docker/for-mac#6189](https://github.com/docker/for-mac/issues/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 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](https://github.com/docker/for-win/issues/12650). - Fixed a bug that prevented using Windows container mode. Fixes [docker/for-win#12652](https://github.com/docker/for-win/issues/12652). ## 4.7.0 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](https://github.com/Mirantis/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](https://github.com/kubernetes/cri-api#readme), the same interface used to control other container runtimes. For more information, see [The Future of Dockershim is cri-dockerd](https://www.mirantis.com/blog/the-future-of-dockershim-is-cri-dockerd/). ### Updates - [Docker Engine v20.10.14](/engine/release-notes/20.10/#201014) - [Compose v2.4.1](https://github.com/docker/compose/releases/tag/v2.4.1) - [Buildx 0.8.2](https://github.com/docker/buildx/releases/tag/v0.8.2) - [containerd v1.5.11](https://github.com/containerd/containerd/releases/tag/v1.5.11) - [Go 1.18](https://golang.org/doc/go1.18) ### Security - Update Docker Engine to v20.10.14 to address [CVE-2022-24769](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2022-24769) - Update containerd to v1.5.11 to address [CVE-2022-24769](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2022-24769) ### Bug fixes and enhancements #### 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](https://github.com/docker/for-mac/issues/6134). - Fixed a problem where gettimeofday() performance drops after waking from sleep when using Hyperkit. Fixes [docker/for-mac#3455](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/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 2022-03-22 ### Updates - [Buildx 0.8.1](https://github.com/docker/buildx/releases/tag/v0.8.1) ### Bug fixes and enhancements - 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](https://github.com/docker/for-mac/issues/6234). - Removed a false positive "vm is not running" error from self-diagnose. Fixes [docker/for-mac#6233](https://github.com/docker/for-mac/issues/6233). ## 4.6.0 2022-03-14 ### New #### For all platforms - The Docker Desktop 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](/desktop/settings-and-maintenance/settings/#beta-features). ### Updates #### For all platforms - [Docker Engine v20.10.13](/engine/release-notes/20.10/#201013) - [Compose v2.3.3](https://github.com/docker/compose/releases/tag/v2.3.3) - [Buildx 0.8.0](https://github.com/docker/buildx/releases/tag/v0.8.0) - [containerd v1.4.13](https://github.com/containerd/containerd/releases/tag/v1.4.13) - [runc v1.0.3](https://github.com/opencontainers/runc/releases/tag/v1.0.3) - [Go 1.17.8](https://golang.org/doc/go1.17) - [Linux kernel 5.10.104](https://hub.docker.com/layers/docker/for-desktop-kernel/5.10.104-379cadd2e08e8b25f932380e9fdaab97755357b3/images/sha256-7753b60f4544e5c5eed629d12151a49c8a4b48d98b4fb30e4e65cecc20da484d?context=explore) ### Security #### For all platforms - Fixed [CVE-2022-0847](https://cve.mitre.org/cgi-bin/cvename.cgi?name=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](https://cve.mitre.org/cgi-bin/cvename.cgi?name=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 - [Qemu 6.2.0](https://wiki.qemu.org/ChangeLog/6.2) ### 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](https://github.com/docker/for-mac/issues/6192). - Fixed a regression about Docker Desktop not starting in background anymore. Fixes [docker/for-mac#6167](https://github.com/docker/for-mac/issues/6167). - Fixed missing Docker Desktop Dock icon. Fixes [docker/for-mac#6173](https://github.com/docker/for-mac/issues/6173). - Used speed up block device access when using the experimental `virtualization.framework`. See [benchmarks](https://github.com/docker/roadmap/issues/7#issuecomment-1050626886). - 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](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-win/issues/12567). - Fixed copying text from terminal in Quick Start Guide. Fixes [docker/for-win#12444](https://github.com/docker/for-win/issues/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 user `nginx` tries to access the same file immediately, the `nginx` process will get a "Permission Denied" error. ## 4.5.1 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 Desktop 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 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](https://www.docker.com/blog/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 - [Amazon ECR Credential Helper v0.6.0](https://github.com/awslabs/amazon-ecr-credential-helper/releases/tag/v0.6.0) ### Security #### For Mac - Fixed [CVE-2021-44719](https://cve.mitre.org/cgi-bin/cvename.cgi?name=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](https://cve.mitre.org/cgi-bin/cvename.cgi?name=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` and `fs.inotify.max_user_instances=8192` in Linux. Fixes [docker/for-mac#6071](https://github.com/docker/for-mac/issues/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 Desktop 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](https://github.com/docker/for-mac/issues/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 2022-01-24 ### Bug fixes and enhancements #### For Windows - Fixed logging in from WSL 2. Fixes [docker/for-win#12500](https://github.com/docker/for-win/issues/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 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](https://github.com/docker/for-win/issues/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 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](/security/authentication/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 - [Docker Engine v20.10.12](/engine/release-notes/20.10/#201012) - [Compose v2.2.3](https://github.com/docker/compose/releases/tag/v2.2.3) - [Kubernetes 1.22.5](https://github.com/kubernetes/kubernetes/releases/tag/v1.22.5) - [docker scan v0.16.0](https://github.com/docker/scan-cli-plugin/releases/tag/v0.16.0) ### Security - Fixed [CVE-2021-45449](/desktop/security/security-announcements/#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 the `allowedOrgs` field. If you are using multiple organizations for different groups of developers, you must provision a separate `registry.json` file for each group. - Fixed a regression in Compose that reverted the container name separator from `-` to `_`. Fixes [docker/compose-switch](https://github.com/docker/compose-switch/issues/24). #### For Mac - Fixed the memory statistics for containers in the Dashboard. Fixes [docker/for-mac/#4774](https://github.com/docker/for-mac/issues/6076). - 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](https://github.com/docker/for-mac/issues/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 2021-12-21 ### Security - Fixed [CVE-2021-45449](/desktop/security/security-announcements/#cve-2021-45449) that affects users currently on Docker Desktop version 4.3.0 or 4.3.1. Docker Desktop version 4.3.0 and 4.3.1 has a bug that may log sensitive information (access token or password) on the user's machine during login. This only affects users if they are on Docker Desktop 4.3.0, 4.3.1 and the user has logged in while on 4.3.0, 4.3.1. Gaining access to this data would require having access to the user’s local files. ### Upgrades [docker scan v0.14.0](https://github.com/docker/scan-cli-plugin/releases/tag/v0.14.0) ### Security **Log4j 2 CVE-2021-44228**: We have updated the `docker scan` CLI plugin. This new version of `docker scan` is able to detect [Log4j 2 CVE-2021-44228](https://nvd.nist.gov/vuln/detail/CVE-2021-44228) and [Log4j 2 CVE-2021-45046](https://nvd.nist.gov/vuln/detail/CVE-2021-45046) For more information, read the blog post [Apache Log4j 2 CVE-2021-44228](https://www.docker.com/blog/apache-log4j-2-cve-2021-44228/). ## 4.3.1 2021-12-11 ### Upgrades [docker scan v0.11.0](https://github.com/docker/scan-cli-plugin/releases/tag/v0.11.0) ### Security **Log4j 2 CVE-2021-44228**: We have updated the `docker scan` CLI plugin for you. Older versions of `docker scan` in Docker Desktop 4.3.0 and earlier versions are not able to detect [Log4j 2 CVE-2021-44228](https://nvd.nist.gov/vuln/detail/CVE-2021-44228). For more information, read the blog post [Apache Log4j 2 CVE-2021-44228](https://www.docker.com/blog/apache-log4j-2-cve-2021-44228/). ## 4.3.0 2021-12-02 ### Upgrades - [Docker Engine v20.10.11](/engine/release-notes/20.10/#201011) - [containerd v1.4.12](https://github.com/containerd/containerd/releases/tag/v1.4.12) - [Buildx 0.7.1](https://github.com/docker/buildx/releases/tag/v0.7.1) - [Compose v2.2.1](https://github.com/docker/compose/releases/tag/v2.2.1) - [Kubernetes 1.22.4](https://github.com/kubernetes/kubernetes/releases/tag/v1.22.4) - [Docker Hub Tool v0.4.4](https://github.com/docker/hub-tool/releases/tag/v0.4.4) - [Go 1.17.3](https://golang.org/doc/go1.17) ### 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](https://github.com/docker/for-win/issues/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 least `systemd` 247](https://github.com/systemd/systemd/issues/19760#issuecomment-851565075). Consider upgrading any `centos:7` images to `centos:8`. - Containers running `systemd` need the following options: [`--privileged --cgroupns=host -v /sys/fs/cgroup:/sys/fs/cgroup:rw`](https://serverfault.com/questions/1053187/systemd-fails-to-run-in-a-docker-container-when-using-cgroupv2-cgroupns-priva). #### 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](https://github.com/docker/for-win/issues/12374). ### Known issue Docker Desktop Dashboard incorrectly displays the container memory usage as zero on Hyper-V based machines. You can use the [`docker stats`](/reference/cli/docker/container/stats/) command on the command line as a workaround to view the actual memory usage. See [docker/for-mac#6076](https://github.com/docker/for-mac/issues/6076). ### Deprecation - The following internal DNS names are deprecated and will be removed from a future release: `docker-for-desktop`, `docker-desktop`, `docker.for.mac.host.internal`, `docker.for.mac.localhost`, `docker.for.mac.gateway.internal`. You must now use `host.docker.internal`, `vm.docker.internal`, and `gateway.docker.internal`. - 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](https://github.com/docker/for-mac/issues/4774). ## 4.2.0 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. - Ships [Docker Public Roadmap#226](https://github.com/docker/roadmap/issues/226) **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. - Ships [Docker Public Roadmap#228](https://github.com/docker/roadmap/issues/228) **Window management**: The Docker Desktop Dashboard window size and position persists when you close and reopen Docker Desktop. ### Upgrades - [Docker Engine v20.10.10](/engine/release-notes/20.10/#201010) - [containerd v1.4.11](https://github.com/containerd/containerd/releases/tag/v1.4.11) - [runc v1.0.2](https://github.com/opencontainers/runc/releases/tag/v1.0.2) - [Go 1.17.2](https://golang.org/doc/go1.17) - [Compose v2.1.1](https://github.com/docker/compose/releases/tag/v2.1.1) - [docker-scan 0.9.0](https://github.com/docker/scan-cli-plugin/releases/tag/v0.9.0) ### 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 Desktop 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 added `DENY DELETE` ACL entries on the corresponding host directory. - Fixed a bug where a `Docker.qcow2` file would be ignored on upgrade and a fresh `Docker.raw` used instead, resulting in containers and images disappearing. Note that if a system has both files (due to the previous bug) then the most recently modified file will be used, to avoid recent containers and images disappearing again. To force the use of the old `Docker.qcow2`, delete the newer `Docker.raw` file. Fixes [docker/for-mac#5998](https://github.com/docker/for-mac/issues/5998). - Fixed a bug where subprocesses could fail unexpectedly during shutdown, triggering an unexpected fatal error popup. Fixes [docker/for-mac#5834](https://github.com/docker/for-mac/issues/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](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-win/issues/12291). ## 4.1.1 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 fresh `Docker.raw` used instead, resulting in containers and images disappearing. If a system has both files (due to the previous bug), then the most recently modified file will be used to avoid recent containers and images disappearing again. To force the use of the old `Docker.qcow2`, delete the newer `Docker.raw` file. Fixes [docker/for-mac#5998](https://github.com/docker/for-mac/issues/5998). - Fixed the update notification overlay sometimes getting out of sync between the **Settings** button and the **Software update** button in the Docker Desktop 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 distributions (e.g. Arch or Alpine). Fixes [docker/for-win#12229](https://github.com/docker/for-win/issues/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 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](https://github.com/docker/roadmap/issues/215) ### Upgrades - [Compose V2](https://github.com/docker/compose/releases/tag/v2.0.0) - [Buildx 0.6.3](https://github.com/docker/buildx/releases/tag/v0.6.3) - [Kubernetes 1.21.5](https://github.com/kubernetes/kubernetes/releases/tag/v1.21.5) - [Go 1.17.1](https://github.com/golang/go/releases/tag/go1.17.1) - [Alpine 3.14](https://alpinelinux.org/posts/Alpine-3.14.0-released.html) - [Qemu 6.1.0](https://wiki.qemu.org/ChangeLog/6.1) - Base distribution 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](https://github.com/microsoft/WSL/issues/5895). - Fixed `SeSecurityPrivilege` requirement issue. See [docker/for-win#12037](https://github.com/docker/for-win/issues/12037). - Fixed CLI context switch sync with UI. See [docker/for-win#11721](https://github.com/docker/for-win/issues/11721). - Added the key `vpnKitMaxPortIdleTime` to `settings.json` to allow the idle network connection timeout to be disabled or extended. - Fixed a crash on exit. See [docker/for-win#12128](https://github.com/docker/for-win/issues/12128). - Fixed a bug where the CLI tools would not be available in WSL 2 distributions. - Fixed switching from Linux to Windows containers that was stuck because access rights on panic.log. See [for-win#11899](https://github.com/docker/for-win/issues/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](https://github.com/docker/for-win/issues/12229) ## 4.0.1 2021-09-13 ### Upgrades - [Compose V2 RC3](https://github.com/docker/compose/releases/tag/v2.0.0-rc.3) - 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 Desktop Dashboard. #### For Windows - Fixed a bug where Docker Desktop would not start correctly with the Hyper-V engine. See [docker/for-win#11963](https://github.com/docker/for-win/issues/11963) ## 4.0.0 2021-08-31 ### New Docker has [announced](https://www.docker.com/blog/updating-product-subscriptions/) 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](https://www.docker.com/legal/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](https://www.docker.com/pricing/faq). For more information, see [Docker subscription overview](/desktop/subscription-billing/). ### Upgrades - [Compose V2 RC2](https://github.com/docker/compose-cli/releases/tag/v2.0.0-rc.2) - Fixed project name to be case-insensitive for `compose down`. See [docker/compose-cli#2023](https://github.com/docker/compose-cli/issues/2023) - Fixed non-normalized project name. - Fixed port merging on partial reference. - [Kubernetes 1.21.4](https://github.com/kubernetes/kubernetes/releases/tag/v1.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](https://github.com/docker/for-mac/issues/5902) #### For Windows - Fixed a bug where the CLI tools would not be available in WSL 2 distributions. - Fixed a bug when switching from Linux to Windows containers due to access rights on `panic.log`. [for-win#11899](https://github.com/docker/for-win/issues/11899)