Troubleshooting your codespace

You can troubleshoot problems with a codespace by checking for known issues in the microsoft/vscode repository.

Codespaces is available for user accounts using GitHub Free or GitHub Pro. For more information, see "GitHub's products."

Note: Codespaces is currently in limited public beta and subject to change. During the beta period, GitHub does not make any guarantees about the availability of Codespaces. For more information about joining the beta, see "About Codespaces."

During the beta, functionality is limited.

  • For the best experience with Codespaces, we recommend using a Chromium-based browser, like Google Chrome or Microsoft Edge.
  • Only a single size of codespace is available.
  • Only Linux containers are supported.
  • A codespace is not fully resumable. Processes that were running at the time the codespace was stopped will not be restarted.

During the beta, private repositories owned by organizations or any repositories owned by an organization that requires SAML single sign-on are not supported.

If you encounter issues while using a browser that is not Chromium-based, try switching to a Chromium-based browser, or check for known issues with your browser in the microsoft/vscode repository by searching for issues labeled with the name of your browser, such asfirefox or safari.

If you encounter issues while using a Chromium-based browser, you can check if you're experiencing another known issue with Visual Studio Code in the microsoft/vscode repository.

If you still need help, you can contact us. For more information, see "About Codespaces."

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.