Skip to content

desktop: note SSL_CERT_FILE behavior change in 4.94.0 release notes - #26601

Merged
aevesdocker merged 1 commit into
docker:mainfrom
mat007:dkp-3202-ssl-cert-file-release-note
Nov 10, 2026
Merged

aevesdocker merged 1 commit into
docker:mainfrom
mat007:dkp-3202-ssl-cert-file-release-note

Conversation

@mat007

@mat007 mat007 commented Nov 10, 2026 •

Copy link
Copy Markdown
Member

Description

Adds a note to the Docker Desktop 4.94.0 release notes about SSL_CERT_FILE and SSL_CERT_DIR now replacing the system certificate store on Windows and macOS.

Related issues or tickets

Reviews

I put it under 4.94.0 because that's the first release whose go.mod has Go 1.27 (go 1.27.1), where this behavior comes from. The Slack thread talks about 4.96.3 to 4.98.0 though, so I'm not sure that's the right version to document it under. Happy to move it.

I only checked Windows, the macOS part comes from the Go 1.27 docs.

  • Technical review
  • Editorial review
  • Product review

@netlify

netlify Bot commented Nov 10, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 59dfe8c
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6af2d57c41a5fad5e5c0a73d
😎 Deploy Preview https://deploy-preview-26601--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added the area/desktop Issue affects a desktop edition of Docker. E.g docker for mac label Nov 10, 2026
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".
@mat007
mat007 force-pushed the dkp-3202-ssl-cert-file-release-note branch from c657165 to 59dfe8c Compare November 10, 2026 08:27
@mat007
mat007 marked this pull request as ready for review November 10, 2026 08:30
@mat007
mat007 requested a review from aevesdocker as a code owner November 10, 2026 08:30

@aevesdocker aevesdocker left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM - agree it should live under 4.94

@aevesdocker
aevesdocker merged commit bee24e7 into docker:main Nov 10, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/desktop Issue affects a desktop edition of Docker. E.g docker for mac

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants