Skip to content

Docker docs: bind the host port to 127.0.0.1 explicitly - #181

Closed
bendichter wants to merge 1 commit into
masterfrom
docker-readme-loopback-bind
Closed

Docker docs: bind the host port to 127.0.0.1 explicitly#181
bendichter wants to merge 1 commit into
masterfrom
docker-readme-loopback-bind

Conversation

@bendichter

Copy link
Copy Markdown
Member

Follow-up to #180, found while validating the pilot image on a laptop. A bare -p 8888:8888 binds all interfaces, and on macOS it can coexist with a local Jupyter server already listening on 127.0.0.1:8888. The browser then reaches the local server instead of the container and shows a confusing 404, because the local server does not know the container's token and may not serve /lab at all. Our target users are exactly the people most likely to have a Jupyter server on port 8888.

Binding the host side to 127.0.0.1 explicitly fixes both halves: the server stays off network interfaces, and a genuine port collision fails loudly with "address already in use" instead of silently splitting the traffic. The docs now also tell users how to pick an alternate host port.

🤖 Generated with Claude Code

A bare -p 8888:8888 binds all interfaces, and on macOS it coexists with
a local Jupyter server already listening on 127.0.0.1:8888, so the
browser silently reaches the wrong server and shows a confusing 404.
Binding 127.0.0.1 explicitly keeps the container off network interfaces
and turns a port collision into a loud "address already in use" error.
Found during the pilot pull-and-run validation.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Index page preview

A preview of the generated index.html has been deployed for this PR:

View preview

Last updated: commit 98293a95a9e471d9bd1cceb934637a383304b505

@bendichter

Copy link
Copy Markdown
Member Author

The commit here is included in #182 (cherry-picked), so this can be closed if #182 merges first.

@bendichter

Copy link
Copy Markdown
Member Author

Closing: the commit landed on master via #182.

@bendichter bendichter closed this Aug 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant