Troubleshooting your connection to Codespaces

Troubleshooting help for connecting to Codespaces.

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

503 codespace service unavailable

Codespaces are set to stop after 30 minutes without any activity. If you try to interact with a codespace after it has stopped, you may see a 503 service unavailable error.

  • If a Start button is shown in Visual Studio Code or in your browser window, click Start to reconnect to the codespace.
  • Reset your codespace by reloading the window. From the command palette in Visual Studio Code, click Developer: Reload Window.

Browser cannot connect

Sometimes you may not be able to access a codespace from your browser. If this happens, go to https://github.com/codespaces and try connecting to the codespace from that page.

  • If the codespace is not listed on that page, check that you are the owner of the codespace you are trying to connect to. You can only open a codespace that you created. The URLs for your codespaces always include your GitHub handle.
  • If the codespace is listed but you cannot connect from that page, check whether you can connect using a different browser.

Your company network may be blocking the connection. If possible, check any logging for rejected connections on your device.

If you still cannot connect, you may need to contact support. For more information, see "Working with support."

GitHub Codespaces extension for Visual Studio Code cannot connect

If you cannot connect to a codespace from Visual Studio Code desktop, use the following troubleshooting steps.

  1. Check that you have the latest version of the GitHub Codespaces extension installed. The extension is a preview release and frequent updates are released.
    1. In Visual Studio Code, display the "Extensions" tab.
    2. Select the GitHub Codespaces extension to display the extension's overview page.
    3. If an update is available, a button is shown, click Update to X.X.X to upgrade to the latest version.
  2. Check whether you are using the stable build of Visual Studio Code or the Visual Studio Code Insiders release (nightly updates). If you are using the insiders release, try installing the stable build.
  3. Your company network may be blocking the connection. If possible, check any logging for rejected connections on your device.

If you still cannot connect, you may need to contact support. For more information, see "Working with support."

The codespace has latency issues

If the codespace seems particularly slow or has latency issues, it is possible that it has been created in a region that is far from you. To resolve this, you can manually set your GitHub Codespaces region.

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.