Skip to main content

Connecting an Azure subscription to your enterprise

You can use your Microsoft Enterprise Agreement to enable and pay for GitHub Actions, GitHub Packages, and Codespaces usage.

About Azure subscriptions and GitHub Enterprise Cloud

If you purchased GitHub Enterprise through a Microsoft Enterprise Agreement, you can connect your Azure Subscription ID to your enterprise account to enable and pay for any Codespaces usage, and for GitHub Actions or GitHub Packages usage beyond the amounts included with your account. For more information, see "About billing for GitHub Actions and "About billing for GitHub Packages."

Note: If your enterprise account is on a Microsoft Enterprise Agreement, connecting an Azure subscription is the only way to use GitHub Actions and GitHub Packages beyond the included amounts, or to use Codespaces at all.

After you connect an Azure subscription, you can also manage your spending limits.

Connecting your Azure subscription to your enterprise account

To connect your Azure subscription, you must have owner permissions to the subscription.

  1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises. "Your enterprises" in drop-down menu for profile photo on GitHub Enterprise Cloud

  2. In the list of enterprises, click the enterprise you want to view. Name of an enterprise in list of your enterprises

  3. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  4. In the left sidebar, click Billing. Billing tab in the enterprise account settings sidebar

  5. Under "Billing", click Payment information.

  6. Under "Payment Information", click Add Azure Subscription.

  7. To sign in to your Microsoft account, follow the prompts.

  8. Review the "Permissions requested" prompt. If you agree with the terms, click Accept.

  9. Under "Select a subscription", select the Azure Subscription ID that you want to connect to your enterprise.

    Note: GitHub's Subscription Permission Validation requests read-only access to display the list of available subscriptions. To select an Azure subscription, you must have owner permissions to the subscription. If the default tenant does not have the right permissions, you may need to specify a different tenant ID. For more information, see Microsoft identity platform and OAuth 2.0 authorization code flow in Microsoft Docs.

  10. Click Connect.

Disconnecting your Azure subscription from your enterprise account

After you disconnect your Azure subscription from your enterprise account, your usage can no longer exceed the amounts included with your plan.

  1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises. "Your enterprises" in drop-down menu for profile photo on GitHub Enterprise Cloud

  2. In the list of enterprises, click the enterprise you want to view. Name of an enterprise in list of your enterprises

  3. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  4. In the left sidebar, click Billing. Billing tab in the enterprise account settings sidebar

  5. Under "Billing", click Payment information.

  6. Under "Azure subscription", to the right of the subscription ID you want to disconnect, click .

  7. Review the prompt, then click Remove.