From 59dfe8caf8fbce6c7469ed24af5607cd46b80197 Mon Sep 17 00:00:00 2001 From: Mathieu Champlon Date: Tue, 10 Nov 2026 09:23:03 +0100 Subject: [PATCH] desktop: note SSL_CERT_FILE behavior change in 4.94.0 release notes Docker Desktop is built with Go 1.27 since 4.94.0. On Windows and macOS, Go 1.27 makes the system cert pool honor SSL_CERT_FILE and SSL_CERT_DIR instead of the platform verifier. When either is set, only the certificates they point to are trusted. A bundle missing a root needed by Docker's endpoints, e.g. the ISRG roots for login.docker.com, now makes sign-in fail with "x509: certificate signed by unknown authority". --- content/manuals/desktop/release-notes.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/manuals/desktop/release-notes.md b/content/manuals/desktop/release-notes.md index 8bae29a0d7a..94ff484949a 100644 --- a/content/manuals/desktop/release-notes.md +++ b/content/manuals/desktop/release-notes.md @@ -355,6 +355,7 @@ For more frequently asked questions, see the [FAQs](/manuals/desktop/troubleshoo #### For Mac +- Docker Desktop now trusts only the certificates in `SSL_CERT_FILE` or `SSL_CERT_DIR` when either is set, instead of the system certificate store. If that bundle lacks a root certificate Docker Desktop needs, such as the ISRG roots used by `login.docker.com`, sign-in fails with `x509: certificate signed by unknown authority`. To fix it, add the missing root certificates to the bundle or unset the variable. - 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. @@ -362,6 +363,7 @@ For more frequently asked questions, see the [FAQs](/manuals/desktop/troubleshoo #### For Windows +- Docker Desktop now trusts only the certificates in `SSL_CERT_FILE` or `SSL_CERT_DIR` when either is set, instead of the system certificate store. If that bundle lacks a root certificate Docker Desktop needs, such as the ISRG roots used by `login.docker.com`, sign-in fails with `x509: certificate signed by unknown authority`. To fix it, add the missing root certificates to the bundle or unset the variable. - 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).