Sitelet https://github.com/docker/docs/pull/26279
Skip to content

docs: add Local Network permission troubleshooting for Mac - #26279

Open
RSalman wants to merge 1 commit into
docker:mainfrom
RSalman:srana/mac-containers-lan-access
Open

RSalman wants to merge 1 commit into
docker:mainfrom
RSalman:srana/mac-containers-lan-access

Conversation

@RSalman

@RSalman RSalman commented Oct 6, 2026

Copy link
Copy Markdown

Description

Adds a Mac troubleshooting topic for containers that can reach the internet but not devices on the local network (LAN). The cause is Docker Desktop not having the macOS Local Network permission: macOS then blocks container traffic to devices on the local network, including the router, while internet traffic still works. The fix is turning on Docker in System Settings > Privacy & Security > Local Network, which takes effect immediately, without restarting Docker Desktop.

Also adds a short Local Network permission section to the Mac permission requirements page that links to the new topic, since that page didn't mention it.

Verified on macOS 26.7 / Docker Desktop 4.92.0 by toggling Local Network for Docker:

  • Off: containers couldn't reach LAN peers or the default gateway (ping, TCP, UDP DNS), while the internet and docker pull kept working.
  • On: access came back immediately, on the same backend process, without restarting Docker Desktop.
  • On a fresh install, macOS prompts for the Local Network permission, so users who hit this have most likely denied that prompt at some point.

Related issues or tickets

Reviews

  • Technical review @mat007
  • Editorial review
  • Product review

@RSalman
RSalman requested a review from aevesdocker as a code owner October 6, 2026 07:25
@netlify

netlify Bot commented Oct 6, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 3284e30
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6ac4a25e17611f000807b60b
😎 Deploy Preview https://deploy-preview-26279--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 Oct 6, 2026

This branch has not been deployed

No deployments
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