From 86b6cee83da0dfa04b1f807566fc96fb85037838 Mon Sep 17 00:00:00 2001 From: aevesdocker Date: Fri, 23 Oct 2026 10:48:34 +0100 Subject: [PATCH 1/2] 4.97-RN Signed-off-by: aevesdocker --- content/manuals/desktop/release-notes.md | 42 ++++++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/content/manuals/desktop/release-notes.md b/content/manuals/desktop/release-notes.md index 9a7947386f6..b0508a745b7 100644 --- a/content/manuals/desktop/release-notes.md +++ b/content/manuals/desktop/release-notes.md @@ -24,6 +24,48 @@ Docker Desktop versions older than 6 months from the latest release are not avai For more frequently asked questions, see the [FAQs](/manuals/desktop/troubleshoot-and-support/faqs/releases.md). +## 4.97.0 + +{{< release-date date="2026-10-26" >}} + +{{< desktop-install-v2 all=true win_arm_release="Early Access" version="4.97.0" build_path="/XXXXXX/" >}} + + +### Bug fixes and enhancements + +#### For all platforms + +- Fixed a spurious Resource Saver error when signing out while sign-in enforcement is enabled. +- Fixed diagnostics collection being slow when the backend is unresponsive, reducing worst-case wait time from several minutes to approximately 3 seconds. +- Added a setting to allow privileged ports (1-1024) to be exposed to other machines on the LAN. +- Fixed reliability issues with the container exec terminal: closing a container no longer triggers spurious error reports, and terminal resize now works correctly on startup. +- Fixed an issue where the Date header in Docker API responses was incorrect after Docker Desktop entered Resource Saver mode. +- Added the `-e`/`--env` flag to `docker pass run` for setting environment variables, including `se://` secret references. +- Fixed `docker pass set` printing "context canceled" on Ctrl-C at the value prompt. +- Fixed a bug where the disk image location could not be moved back to a folder it had previously been moved out of. Fixes [docker/desktop-feedback#565](https://github.com/docker/desktop-feedback/issues/565). +- Fixed adding Docker Desktop commands to the PATH failing for fish users without a `~/.config/fish` directory. +- Fixed a bug where the installer could leave a file under `C:\ProgramData\DockerDesktop` with no permissions at all, making it unreadable to diagnostics and to later installs. +- Fixed a bug where a failed update could put back Start Menu and desktop shortcuts that had been deleted on purpose. +- Improved responsiveness when searching the **Images**, **Containers** and **Volumes** lists. +- Fixed an unhandled error when viewing the files of a Compose project whose config file no longer exists. + +#### For Mac + +- `--user` mode is now the default for new Docker Desktop `.EXE` installations. +- Fixed double obfuscation of diagnostic files that significantly slowed down diagnostics collection. + +#### For Windows + +- Added a Docker VMM (Beta) backend option to the Windows installer. +- Fixed an issue on Windows where a slow WSL version check asked to update WSL. +- Fixed Docker VMM requiring a Docker Desktop restart to share a new bind-mount directory from the host. +- Fixed WSL installer errors (e.g. `Wsl/CallMsi/`) being misidentified as disk-related failures, preventing misleading 'disk file has been deleted' recovery messages. +- Fixed Docker Desktop becoming unresponsive, with `docker` commands hanging and Quit not working, after the disk filled up or, on Windows, after the backend's console host process exited. Fixes [docker/desktop-feedback#429](https://github.com/docker/desktop-feedback/issues/429) and [docker/desktop-feedback#699](https://github.com/docker/desktop-feedback/issues/699). +- Made gathering diagnostics on Windows faster. +- Fixed an issue where the installer rejected `--backend=docker-vmm` when combined with `--user` flag or Microsoft Store installs. +- Fixed factory reset to stop Docker engines before deleting data, surface cleanup failures as an error dialog, and clean up custom data-root directories. +- Fixed Windows containers failing to start with a "Path contains symlink" error on `callback.sock`. + ## 4.96.3 {{< release-date date="2026-10-22" >}} From b59ed6b86cf2652ecf8b294d1e83363e86b95914 Mon Sep 17 00:00:00 2001 From: aevesdocker Date: Fri, 23 Oct 2026 11:15:42 +0100 Subject: [PATCH 2/2] move issues Signed-off-by: aevesdocker --- content/manuals/desktop/release-notes.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/content/manuals/desktop/release-notes.md b/content/manuals/desktop/release-notes.md index b0508a745b7..83f9197e24c 100644 --- a/content/manuals/desktop/release-notes.md +++ b/content/manuals/desktop/release-notes.md @@ -37,22 +37,17 @@ For more frequently asked questions, see the [FAQs](/manuals/desktop/troubleshoo - Fixed a spurious Resource Saver error when signing out while sign-in enforcement is enabled. - Fixed diagnostics collection being slow when the backend is unresponsive, reducing worst-case wait time from several minutes to approximately 3 seconds. -- Added a setting to allow privileged ports (1-1024) to be exposed to other machines on the LAN. - Fixed reliability issues with the container exec terminal: closing a container no longer triggers spurious error reports, and terminal resize now works correctly on startup. - Fixed an issue where the Date header in Docker API responses was incorrect after Docker Desktop entered Resource Saver mode. - Added the `-e`/`--env` flag to `docker pass run` for setting environment variables, including `se://` secret references. - Fixed `docker pass set` printing "context canceled" on Ctrl-C at the value prompt. -- Fixed a bug where the disk image location could not be moved back to a folder it had previously been moved out of. Fixes [docker/desktop-feedback#565](https://github.com/docker/desktop-feedback/issues/565). -- Fixed adding Docker Desktop commands to the PATH failing for fish users without a `~/.config/fish` directory. -- Fixed a bug where the installer could leave a file under `C:\ProgramData\DockerDesktop` with no permissions at all, making it unreadable to diagnostics and to later installs. -- Fixed a bug where a failed update could put back Start Menu and desktop shortcuts that had been deleted on purpose. - Improved responsiveness when searching the **Images**, **Containers** and **Volumes** lists. - Fixed an unhandled error when viewing the files of a Compose project whose config file no longer exists. #### For Mac -- `--user` mode is now the default for new Docker Desktop `.EXE` installations. -- Fixed double obfuscation of diagnostic files that significantly slowed down diagnostics collection. +- Fixed adding Docker Desktop commands to the PATH failing for fish users without a `~/.config/fish` directory. +- Added a setting to allow privileged ports (1-1024) to be exposed to other machines on the LAN. #### For Windows @@ -61,10 +56,13 @@ For more frequently asked questions, see the [FAQs](/manuals/desktop/troubleshoo - Fixed Docker VMM requiring a Docker Desktop restart to share a new bind-mount directory from the host. - Fixed WSL installer errors (e.g. `Wsl/CallMsi/`) being misidentified as disk-related failures, preventing misleading 'disk file has been deleted' recovery messages. - Fixed Docker Desktop becoming unresponsive, with `docker` commands hanging and Quit not working, after the disk filled up or, on Windows, after the backend's console host process exited. Fixes [docker/desktop-feedback#429](https://github.com/docker/desktop-feedback/issues/429) and [docker/desktop-feedback#699](https://github.com/docker/desktop-feedback/issues/699). -- Made gathering diagnostics on Windows faster. - Fixed an issue where the installer rejected `--backend=docker-vmm` when combined with `--user` flag or Microsoft Store installs. - Fixed factory reset to stop Docker engines before deleting data, surface cleanup failures as an error dialog, and clean up custom data-root directories. - Fixed Windows containers failing to start with a "Path contains symlink" error on `callback.sock`. +- Fixed a bug where the installer could leave a file under `C:\ProgramData\DockerDesktop` with no permissions at all, making it unreadable to diagnostics and to later installs. +- Fixed a bug where the disk image location could not be moved back to a folder it had previously been moved out of. Fixes [docker/desktop-feedback#565](https://github.com/docker/desktop-feedback/issues/565). +- Fixed a bug where a failed update could put back Start Menu and desktop shortcuts that had been deleted on purpose. +- `--user` mode is now the default for new Docker Desktop `.EXE` installations. ## 4.96.3