Skip to content

Conversation

andyli11
Copy link
Owner

Summary

This PR updates the README.md to recommend using port 8000 instead of Flask’s default port 5000 when running the app locally. This avoids conflicts with the AirPlay Receiver on macOS Monterey and newer (2022+), which occupies port 5000.

Changes

  • Switched flask run command to flask run --port=8000
  • Updated local URLs to reflect port 8000

Underlying Issue

Using port 5000 on newer versions of macOS can cause Flask apps to silently fail with a 403 error. Switching to port 8000 ensures a smoother developer experience across platforms without needing manual system configuration.

image

Testing

  • Verified that the app runs and is accessible at http://localhost:8000 and http://127.0.0.1:8000
  • Confirmed that no conflicts occur on macOS

@andyli11 andyli11 merged commit b5a76f3 into main Jul 14, 2025
@andyli11 andyli11 deleted the port-change branch July 14, 2025 22:59
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