Changing the machine type for your codespace

You can change the type of machine that's running your codespace, so that you're using resources appropriate for work you're doing.

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

About machine types

Note: You can only select or change the machine type if you are a member of an organization using Codespaces and are creating a codespace on a repository owned by that organization.

You can run your codespace on a choice of remote machine, from 2 cores to 32 cores. Each of these has a different level of resources and a different billing tier. For information, see "About billing for Codespaces."

You can choose a machine type either when you create a codespace or you can change the machine type at any time after you've created a codespace.

For information on choosing a machine type when you create a codespace, see "Creating a codespace." For information on changing the machine type within Visual Studio Code, see "Using Codespaces in Visual Studio Code."

Changing the machine type in GitHub

  1. In the top right corner of GitHub, click your profile photo, then click Your codespaces.

    'Your codespaces' menu option

    The current machine type for each of your codespaces is displayed.

    'Your codespaces' list

  2. Click the ellipsis (...) to the right of the codespace you want to modify.

  3. Click Change machine type.

    'Change machine type' menu option

  4. Choose the required machine type.

  5. Click Update codespace.

    The change will take effect the next time your codespace restarts.

Force an immediate update of a currently running codespace

If you change the machine type of a codespace you are currently using, and you want to apply the changes immediately, you can force the codespace to restart.

  1. At the bottom left of your codespace window, click Codespaces.

    Click 'Codespaces'

  2. From the options that are displayed at the top of the page select Codespaces: Stop Current Codespace.

    'Suspend Current Codespace' option

  3. After the codespace is stopped, click Restart codespace.

    Click 'Resume'

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.