Skip to main content

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.

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 machine types

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

Typically, 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 GitHub Codespaces."

By default the machine type with the lowest valid resources is used when you create a codespace. You can choose an alternative machine type either when you create a codespace or 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, 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. If multiple machine types are available for your codespace, choose the type of machine you want to use.

    Dialog box showing available machine types to choose

    Note: Your choice of available machine types may be limited by a policy configured for your organization, or by a minimum machine type specification for your repository. For more information, see "Restricting access to machine types" and "Setting a minimum specification for codespace machines."

  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'