Prerequisites
Before you start, make sure you know:
- GitHub username of the client who will become the owner of the enterprise you create
- GitHub username for the CSP partner that must be assigned to the customer’s enterprise account to manage metered billing and access support
- Enterprise name your client would like to use
- Email address for receipts
- Number of seats your client needs in the enterprise
- Enterprise account type required by your client, see Choosing an enterprise type for GitHub Enterprise Cloud
Step 1: Create the enterprise account in the Azure portal
As a Microsoft CSP partner, you can get started with GitHub Enterprise from the Microsoft Azure portal.
- Sign in to the Microsoft Azure portal.
- In the search bar, type "GitHub" and select GitHub to go the landing page.
- Select Get started with GitHub Enterprise.
- Choose an enterprise type. To help you decide which choice is best for the enterprise, see Choosing an enterprise type for GitHub Enterprise Cloud.
- Complete the form with your client's information.
- Click Create your enterprise.
Step 2: Purchase GitHub Enterprise
At any time during the trial, you can purchase GitHub Enterprise for your client by linking it to their Azure subscription. If the account is later transferred to the customer, ensure the Azure subscription is fully managed by them.
-
In the top-right corner of GitHub, click your profile picture.
-
Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.
-
At the top of the page, in the blue banner, click Activate Enterprise.
-
Click Add Azure subscription.
-
To sign in to your Microsoft account, follow the prompts.
-
Review the "Permissions requested" prompt. If you agree with the terms, click Accept.
If you don't see a "Permissions requested" prompt, and instead see a message indicating that you need admin approval, see Troubleshooting Azure subscription connection problems.
-
Under "Select a subscription", select the Azure Subscription ID that you want to connect to your organization. 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 Azure subscription payments and Microsoft identity platform and OAuth 2.0 authorization code flow in Microsoft Docs.
- Select By clicking "Connect", you are confirming that you want to be billed for metered services via the selected Azure subscription.
- Click Connect.
-
Click Activate Enterprise.
Step 3: Invite your client as an enterprise owner
Invite your client to become an enterprise owner. See Inviting people to manage your enterprise.
Step 4: Change your role to billing manager
Optionally, you can change your role to billing manager to manage the billing for the enterprise account, without having full administrative access.
-
In the top-right corner of GitHub, click your profile picture.
-
Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.
-
At the top of the page, click People.
-
Under " People", click Administrators.
-
Confirm that your client is listed as an enterprise owner.
-
To the right of your username, select the dropdown menu, then click Change role.
-
Select Billing manager, then click Change role.
Contacting support
As a Microsoft CSP partner, you can use the GitHub Support for Microsoft CSP landing page to speak to GitHub Support. For more information about creating a support ticket, see Creating a support ticket.