Salman RanaandAllie Sadler d533c61c19 docs: add Local Network permission troubleshooting for Mac (#26279)
<!--Delete sections as needed -->

## 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

- https://github.com/docker/desktop-feedback/issues/636

## Reviews

- [ ] Technical review @mat007
- [ ] Editorial review
- [ ] Product review

---------

Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
2026-10-20 15:40:39 +01:00
2025-01-30 07:54:26 -08:00
2026-09-11 12:37:25 +02:00
2026-03-31 15:20:07 +02:00
2026-01-05 08:34:39 +01:00
2024-09-16 14:43:05 +02:00
2025-07-16 15:13:38 +02:00
2026-09-11 12:37:25 +02:00
2026-10-02 18:11:08 +02:00
…
2025-04-02 15:46:24 -04:00

Docs @ Docker

Welcome to Docker Documentation


Welcome to the Docker Documentation repository. This is the source for the Docker Docs Website.

Feel free to open pull requests or issues. Our docs are completely open source, and we deeply appreciate contributions from the Docker community!

Provide feedback

We’d love to hear your feedback! To submit feedback:

  • Click New issue on the docs repository, or
  • Click Request changes in the right column of every page on docs.docker.com, or
  • Click Give feedback on every page in the docs.

To get community support, use the Docker Community Slack. Personalized support is available through the Docker Pro, Team, and Business subscriptions. See Docker Pricing for details.

If you have an idea for a new feature or behavior change in a specific aspect of Docker or have found a product bug, file an issue in the project's repository.

Contribute to Docker docs

We welcome contributions! To get started:

Copyright 2013-2026 Docker, Inc., released under the Apache 2.0 license.

S
Description
No description provided
Readme Apache-2.0
902 MiB
0 Stars 1 Watchers 0 Forks
Languages
Markdown 94.8%
HTML 2.4%
JavaScript 0.8%
CSS 0.7%
Go 0.7%
Other 0.2%