docs: troubleshoot port-8000 shadowing in the local-mode quickstart - #57
Closed
markadams31 wants to merge 1 commit into
Closed
docs: troubleshoot port-8000 shadowing in the local-mode quickstart#57markadams31 wants to merge 1 commit into
markadams31 wants to merge 1 commit into
Conversation
A leftover native process bound to 127.0.0.1:8000 (e.g. a forgotten uvicorn from the hosted dev loop) coexists silently with Docker's wildcard publish on Windows — compose starts cleanly, but localhost resolves to the native process, so the browser lands on an entra-mode backend whose 401s bounce the SPA to the (locally nonexistent) EasyAuth login route. Hit within an hour of the feature merging; document the symptom, the diagnosis one-liner, and both remedies (stop the shadow or AUTOCRUD_PORT). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Owner
Author
|
Not needed - closing. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documents the first real-world failure of the zero-Azure quickstart (hit within an hour of #56 merging): a leftover native process bound to
127.0.0.1:8000coexists silently with Docker's wildcard publish on Windows, sodocker compose upsucceeds butlocalhost:8000serves the shadow process — an entra-mode backend whose 401s bounce the SPA to/.auth/login/aad, which 404s locally.Adds a callout to the quickstart with the symptom, the one-liner to diagnose (
Get-NetTCPConnection/lsof), the identity sanity check (curl localhost:8000/me→"sa (local)"), and both remedies (stop the shadow, orAUTOCRUD_PORT=8080).🤖 Generated with Claude Code