Skip to content

Update documents with note about container-to-host networking.#1482

Merged
jglogan merged 1 commit into
apple:mainfrom
jglogan:localhost-note
Apr 30, 2026
Merged

Update documents with note about container-to-host networking.#1482
jglogan merged 1 commit into
apple:mainfrom
jglogan:localhost-note

Conversation

@jglogan
Copy link
Copy Markdown
Contributor

@jglogan jglogan commented Apr 30, 2026

  • Currently we need to use pfctl to create the packet filter rule for container-to-host networking (host.docker.internal). This approach unfortunately has a few limitations that require documentation.

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation update

Motivation and Context

See above. Documentation-only change.

Testing

  • Tested locally
  • Added/updated tests
  • Added/updated docs

- Currently we need to use `pfctl` to create the
  packet filter rule for container-to-host
  networking (`host.docker.internal`). This
  approach unfortunately has a few limitations
  that require documentation.
@jglogan jglogan requested a review from JaewonHur April 30, 2026 18:16
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Apr 30, 2026
Comment thread docs/how-to.md

> [!IMPORTANT]
> Due to macOS security constraints around packet filter rules, this feature has limited functionality:
> - Creating a localhost domain disables Private Relay.
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.

Nit but should we link to what Private Relay is?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I'm not sure how stable https://support.apple.com/guide/mac-help/use-icloud-private-relay-mchlecadabe0/mac is (and it's an release-specific link).

@jglogan jglogan merged commit 1ee2d9d into apple:main Apr 30, 2026
4 checks passed
@jglogan jglogan deleted the localhost-note branch April 30, 2026 22:05
noah-thor pushed a commit to noah-thor/container that referenced this pull request May 6, 2026
…#1482)

- Currently we need to use `pfctl` to create the packet filter rule for
container-to-host networking (`host.docker.internal`). This approach
unfortunately has a few limitations that require documentation.
Copy link
Copy Markdown

@natevw natevw left a comment

Choose a reason for hiding this comment

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

re. https://github.com/apple/container/pull/1482/changes#diff-9e8925e42639363dcd93a5b15f44f908bb99cea6b9a9723493cf014fa131493bR77 now at

Normally, vmnet creates the container network using the CIDR address 192.168.64.1/24, and on macOS 15, `container` defaults to using this CIDR address in the network helper. If your containers have no network access on macOS 15, see [All networking fails on macOS 15](troubleshooting.md#all-networking-fails-on-macos-15) for diagnosis and remediation steps.

was this troubleshooting.md file intended to be included in the PR? it's now a broken link :-/

[update: filed as #1604 ]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants