Skip to content

docs: update mac permission requirements for removed privileged helper - #25929

Draft
ebriney wants to merge 1 commit into
docker:mainfrom
ebriney:docs/mac-permission-requirements-update
Draft

docs: update mac permission requirements for removed privileged helper#25929
ebriney wants to merge 1 commit into
docker:mainfrom
ebriney:docs/mac-permission-requirements-update

Conversation

@ebriney

@ebriney ebriney commented Aug 25, 2026

Copy link
Copy Markdown
Member

Description

Docker Desktop for Mac no longer starts a privileged helper process to bind privileged ports (<1024) or cache the Registry Access Management policy, and no longer shows a first-run installation window for privileged access. This updates the docs accordingly:

  • Removed the "Privileged helper" section (and the vmnetd example) from mac-permission-requirements.md
  • Removed the "Binding privileged ports" section and related bullets/links
  • Removed the "Securely caching the Registry Access Management policy" bullet from both mac-permission-requirements.md and windows-permission-requirements.md
  • Removed the "Allow privileged port mapping" setting from settings.md, and the matching mention in mac-install.md
  • Reworded the intro of the Permission requirements section: privileged access (CLI tools location, default Docker socket) is now managed from the Advanced page in Settings, not granted via a first-run install screen
  • Updated "Installing symlinks": the default is now $HOME/.docker/bin, automatically added to PATH; /usr/local/bin is an opt-in, password-gated alternative from Advanced settings
  • Updated the Advanced (Mac only) settings table to match: System now notes "Requires password", User notes it's the default with automatic PATH setup, and dropped the "set during initial install" framing

Related issues or tickets

DKP-2730

Reviews

  • Technical review
  • Editorial review
  • Product review

Docker Desktop for Mac no longer uses a privileged helper process to
bind privileged ports or cache the Registry Access Management policy,
and no longer presents a first-run installation window. Update the
docs to reflect that privileged configuration (CLI tools location,
default Docker socket) is now managed from the Advanced page in
Settings, that $HOME/.docker/bin is the default and automatically
added to PATH, and remove the now-obsolete privileged port mapping
references.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@netlify

netlify Bot commented Aug 25, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 2b7e95a
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a8db33cc671bc0008b7a8ff
😎 Deploy Preview https://deploy-preview-25929--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 Aug 25, 2026
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.

1 participant