Troubleshooting port forwarding for Codespaces

Troubleshooting steps for common port forwarding issues.

Codespaces is available for organizations using GitHub Team or GitHub Enterprise Cloud. For more information, see "GitHub's products."

When an application running inside a codespace outputs a port to the console, Codespaces detects the localhost URL pattern and automatically forwards the port. For more information, see "Forwarding ports in your codespace."

If a port is not automatically forwarded, you can forward it manually. For more information, see "Forwarding a port."

If port forwarding is set up, check the following:

  • Use the notification toast or click the URL in Terminal to open the forwarded port. Typing in localhost:8000 (as an example) to your local machine will not work if you're connected to the codespace via the browser.
  • Make sure to check that your application is still running from within your codespace. If your codespace has stopped after a period of inactivity, you'll need to ensure to restart your application once the codespace has restarted.

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.