Skip to main content

Stopping and starting a codespace

You can stop and start your codespace to save resources and to pause work.

GitHub Codespaces is available for organizations using GitHub Team or GitHub Enterprise Cloud. GitHub Codespaces is also available as a limited beta release for individual users on GitHub Free and GitHub Pro plans. For more information, see "GitHub's products."

About stopping and starting a codespace

You can stop a codespace at any time. When you stop a codespace, any running processes are stopped and the terminal history is cleared. Any saved changes in your codespace will still be available when you next start it. If you do not explicitly stop a codespace, it will continue to run until it times out from inactivity. For more information, see "Codespaces timeouts."

Only running codespaces incur CPU charges; a stopped codespace incurs only storage costs.

You may want to stop and restart a codespace to apply changes to it. For example, if you change the machine type used for your codespace, you will need to stop and restart it for the change to take effect. You can also stop your codespace and choose to restart or delete it if you encounter an error or something unexpected.

Regardless of where you created or access your codespaces, you can view and manage them in your browser at https://github.com/codespaces.

Stopping a codespace

  1. Navigate to the "Your Codespaces" page at https://github.com/codespaces.

  2. To the right of the codespace you want to stop, click the elipsis (...).

  3. Click Stop codespace. Screenshot of option to stop a codespace

To learn more about GitHub CLI, see "About GitHub CLI."

To stop a codespace use the gh codespace stop subcommand and then choose the codespace you want to stop from the list that's displayed.

Shell
gh codespace stop
  1. Open the VS Code Command Palette (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)).

  2. Type stop and select Codespaces: Stop Codespace from the list of options.

  3. In the list of codespaces, select the codespace you want to stop.

Restarting a codespace

  1. Navigate to the "Your Codespaces" page at https://github.com/codespaces.

  2. Click the name of the codespace you want to restart. Screenshot of stopped codespaces

When you restart a codespace you can choose to open it in Visual Studio Code or in your browser.

  • To restart a codespace and open it in Visual Studio Code, use the gh codespace code subcommand and then choose the codespace you want to restart from the list that's displayed.

    Shell
    gh codespace code
  • To restart a codespace and open it in your browser, use the gh codespace open --web subcommand and then choose the codespace you want to restart from the list that's displayed.

    Shell
    gh codespace open --web
  1. Open the VS Code Command Palette (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)).

  2. Type connect and select Codespaces: Connect to Codespace from the list of options.

  3. In the list of codespaces, select the codespace you want to restart.

Further reading