About Visual Studio subscription with GitHub Enterprise
Visual Studio subscription with GitHub Enterprise is a combined offering from Microsoft that allows a subscriber to use both GitHub Enterprise and Visual Studio. Visual Studio subscription with GitHub Enterprise is available from Microsoft under the terms of the Microsoft Enterprise Agreement. For more information, see Visual Studio subscription with GitHub Enterprise on the Visual Studio website.
After you assign a license for Visual Studio subscription with GitHub Enterprise to a subscriber, the subscriber will use the GitHub Enterprise portion of the license by joining an organization in your enterprise account with a user account on GitHub.com. If the email address for the user account of an enterprise member on GitHub.com matches the User Primary Name (UPN) for a subscriber to your Visual Studio account, the Visual Studio subscriber will automatically consume one license for Visual Studio subscription with GitHub Enterprise.
The total quantity of your licenses for your enterprise on GitHub is the sum of any standard GitHub Enterprise licenses and the number of Visual Studio subscription licenses that include access to GitHub. If the user account for an enterprise member does not correspond with the email address for a Visual Studio subscriber, the license that the user account consumes is unavailable for a Visual Studio subscriber.
For more information about GitHub Enterprise, see "GitHub's products." For more information about accounts on GitHub.com, see "Types of GitHub accounts."
Prerequisites
-
After you buy Visual Studio subscription with GitHub Enterprise, contact GitHub's Sales team and mention "Visual Studio subscription with GitHub Enterprise." You'll work with the Sales team to create an enterprise account on GitHub.com. If you already have an enterprise account on GitHub.com, or if you're not sure, please tell our Sales team.
-
Assign licenses for Visual Studio subscription with GitHub Enterprise to subscribers in the administrator portal for Visual Studio subscriptions. For more information about assigning licenses, see Manage Visual Studio subscriptions with GitHub Enterprise in the Microsoft Docs.
-
On GitHub.com, create at least one organization owned by your enterprise account. For more information, see "Adding organizations to your enterprise account."
Inviting a subscriber to use GitHub Enterprise
To use the GitHub Enterprise portion of the license, the subscriber's user account on GitHub.com must be or become a member of an organization owned by your enterprise on GitHub.com.
Organization owners can invite new members to an organization by email address. The subscriber can accept the invitation with an existing user account on GitHub.com or create a new account.
While not required, we recommend that organization owners send an invitation to the same email address used for the Visual Studio subscriber's User Primary Name (UPN). When the email address on GitHub matches the subscriber's UPN, you can ensure that another member of the organization does not claim the subscriber's license.
For more information, see "Inviting users to join your organization," "Signing up for GitHub," and "Managing email preferences."
Viewing GitHub Enterprise licensing
After assigning a license for Visual Studio subscription with GitHub Enterprise in the administrator portal for Visual Studio subscriptions, you can view the number of GitHub Enterprise licenses available to your enterprise account. For more information, see "Viewing the subscription and usage for your enterprise account."
You can also see pending GitHub Enterprise invitations to subscribers in the administrator portal for Visual Studio subscriptions. The list of pending invitations includes subscribers who are not yet members of at least one organization in your enterprise account. For more information, see "Viewing people in your enterprise."
Further reading
- Introducing Visual Studio subscriptions with GitHub Enterprise in the Microsoft Docs