1
0
mirror of synced 2025-12-19 18:10:59 -05:00
Files
docs/content/codespaces/managing-codespaces-for-your-organization/enabling-github-codespaces-for-your-organization.md
2023-01-26 16:13:09 +00:00

6.4 KiB

title, shortTitle, intro, permissions, redirect_from, versions, type, topics
title shortTitle intro permissions redirect_from versions type topics
Enabling GitHub Codespaces for your organization Enable {% data variables.product.prodname_codespaces %} You can control which users in your organization can use {% data variables.product.prodname_github_codespaces %} at the organization's expense. To alter an organization's billing settings, you must be an organization owner.
/codespaces/managing-codespaces-for-your-organization/managing-user-permissions-for-your-organization
/codespaces/managing-codespaces-for-your-organization/enabling-codespaces-for-your-organization
fpt ghec
* *
how_to
Codespaces
Billing
Administrator

About enabling {% data variables.product.prodname_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 {% data variables.product.prodname_github_codespaces %}."

Only people who can either push changes to a repository, or fork the repository, can create a codespace for that repository. To allow a user to create codespaces for a repository owned by your organization, you must do one of the following things.

  • Ensure that the user has read access to the repository, and the repository permits forking, so that the user can create a codespace from the repository, push their changes to a fork, and create a pull request for any changes they want to make. For more information, see "Managing the forking policy for your organization."
  • Ensure that the user has write access to the repository, so that they can push changes directly to the repository without forking.

You must also ensure that your organization does not have an IP address allow list enabled. For more information, see "[Managing allowed IP addresses for your organization](/{% ifversion fpt %}enterprise-cloud@latest/{% endif %}organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %}

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

{% ifversion fpt %} {% note %}

Note: If you are a verified educator or a teacher, you must enable {% data variables.product.prodname_github_codespaces %} from a {% data variables.product.prodname_classroom %} to use your {% data variables.product.prodname_codespaces %} Education benefit. For more information, see "Using {% data variables.product.prodname_github_codespaces %} with {% data variables.product.prodname_classroom %}."

{% endnote %} {% endif %}

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

{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.click-codespaces %}

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

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

    Radio buttons for "Billing"

    {% note %}

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

    {% endnote %}

  2. Click Save.

  3. 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 {% data variables.product.prodname_codespaces %} for your organization

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

{% data reusables.codespaces.codespaces-disabling-org-billing %}

{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.organizations.click-codespaces %}

  1. Under "Billing," select Disabled.

Setting a spending limit

{% data reusables.codespaces.codespaces-spending-limit-requirement %}

For information on managing and changing your account's spending limit, see "Managing your spending limit for {% data variables.product.prodname_codespaces %}."