Skip to main content
 

 

Enabling GitHub Codespaces for your organization

In this article

You can control which users in your organization can use GitHub Codespaces at the organization's expense.

Who can use this feature

To alter an organization's billing settings, you must be an organization owner.

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 enabling GitHub Codespaces for your organization

Organization owners can control which users in your organization can create and use codespaces at the organization's expense. For information about pricing, see "About billing for GitHub Codespaces."

Only people who can clone a repository can create a codespace for that repository. To allow people to create codespaces for repositories owned by your organization, you must:

To allow people to create codespaces for which your organization will be billed, you must:

Note: If you are a verified educator or a teacher, you must enable Codespaces from a GitHub Classroom to use your Codespaces Education benefit. For more information, see "Using GitHub Codespaces with GitHub Classroom."

By default, a codespace can only access the repository from which it was created. If you want codespaces in your organization to be able to access other organization repositories that the codespace creator can access, see "Managing repository access for your organization's codespaces."

Choose who can create codespaces that are billed to your organization

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu

  2. Next to the organization, click Settings. The settings button

  3. In the left sidebar, click Codespaces.

  4. Under "Billing," select one of the following options:

    • Disabled - Your organization will not be charged for codespace usage. Codespaces created for your organization's repositories will be billed to the individual users who create them.
    • Selected members - Codespaces created for your organization's repositories by selected members will be billed to the organization.
    • All members - Codespaces created for your organization's repositories by members of your organization will be billed to the organization.
    • All members and outside collaborators - Codespaces created for your organization's repositories by organization members and outside collaborators will be billed to the organization.

    Radio buttons for "Billing"

    Note: When you select All members and outside collaborators, all outside collaborators who have been added to specific repositories can create and use Codespaces for those repositories, and your organization will be billed for this usage. For more information on managing outside collaborators, see "About outside collaborators."

  5. Click Save.

  6. If you chose Selected members, an input box is displayed for you to enter the names of users you want to select.

    Input box for selecting users

Disabling Codespaces for your organization

You can prevent the creation and use of codespaces billable to your organization.

Note: If you disable billable codespaces use for your organization, anyone who can clone a repository in your organization, will still be able to create a codespace for that repository by using their personal account. However, this will not incur any charge for your organization. For information about restricting access to a repository, see "Managing teams and people with access to your repository."

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu
  2. Next to the organization, click Settings. The settings button
  3. In the left sidebar, click Codespaces.
  4. Under "Billing," select Disabled.

Setting a spending limit

Note: You must set a non-zero spending limit before you can use GitHub Codespaces.

By default, your organization or enterprise will have a GitHub Codespaces spending limit of $0. This prevents new codespaces from being created, or existing codespaces from being opened, if this would incur a billable cost to your organization or enterprise. To allow your users to create codespaces in your organization, set the limit to a value higher than $0.

For information on managing and changing your account's spending limit, see "Managing your spending limit for Codespaces."