docs/content/billing/managing-licenses-for-visual-studio-subscriptions-with-github-enterprise/setting-up-visual-studio-subscriptions-with-github-enterprise.md

title, intro, versions, type, topics, shortTitle

title	intro	versions	type	topics	shortTitle
Setting up Visual Studio subscriptions with GitHub Enterprise	Your team's subscription to {% data variables.product.prodname_vs %} can also provide access to {% data variables.product.prodname_enterprise %}.	ghec *	how_to	Enterprise Licensing	Set up

About setup of {% data variables.visual_studio.prodname_vss_ghe %}

{% data reusables.enterprise-accounts.vss-ghe-description %} For more information, see "AUTOTITLE."

This guide shows you how your team can get {% data variables.product.prodname_vs %} subscribers licensed and started with {% data variables.product.prodname_enterprise %}.

Roles for {% data variables.visual_studio.prodname_vss_ghe %}

Before setting up {% data variables.visual_studio.prodname_vss_ghe %}, it's important to understand the roles for this combined offering.

Role	Service	Description	More information
Subscriptions admin	{% data variables.product.prodname_vs %} subscription	Person who assigns licenses for {% data variables.product.prodname_vs %} subscription	Overview of admin responsibilities in Microsoft Docs
Subscriber	{% data variables.product.prodname_vs %} subscription	Person who uses a license for {% data variables.product.prodname_vs %} subscription	Visual Studio Subscriptions documentation in Microsoft Docs
Enterprise owner	{% data variables.product.prodname_dotcom %}	Person who has a personal account that's an administrator of an enterprise on {% data variables.location.product_location %}	"AUTOTITLE"
Organization owner	{% data variables.product.prodname_dotcom %}	Person who has a personal account that's an owner of an organization in your team's enterprise on {% data variables.location.product_location %}	"AUTOTITLE"
Enterprise member	{% data variables.product.prodname_dotcom %}	Person who has a personal account that's a member of an enterprise on {% data variables.location.product_location %}	"AUTOTITLE"

Prerequisites

• Your team's {% data variables.product.prodname_vs %} subscription must include {% data variables.product.prodname_enterprise %}. For more information, see {% data variables.product.prodname_vs %} Subscriptions and Benefits on the {% data variables.product.prodname_vs %} website and Overview of admin responsibilities in Microsoft Docs.

• Your team must have an enterprise on {% data variables.location.product_location %}. If you're not sure whether your team has an enterprise, contact your {% data variables.product.prodname_dotcom %} administrator. If you're not sure who on your team is responsible for {% data variables.product.prodname_dotcom %}, contact {% data variables.contact.contact_enterprise_sales %}. For more information, see "AUTOTITLE."

Setting up {% data variables.visual_studio.prodname_vss_ghe %}

To set up {% data variables.visual_studio.prodname_vss_ghe %}, members of your team must complete the following tasks.

One person may be able to complete the tasks because the person has all of the roles, but you may need to coordinate the tasks with multiple people. For more information, see "Roles for {% data variables.visual_studio.prodname_vss_ghe %}."

1. An enterprise owner must create at least one organization in your enterprise on {% data variables.location.product_location %}. For more information, see "AUTOTITLE."

2. The subscription admin must assign a license for {% data variables.product.prodname_vs %} to a subscriber in {% data variables.visual_studio.prodname_vss_admin_portal_with_url %}. For more information, see Overview of the {% data variables.product.prodname_vs %} Subscriptions Administrator Portal and Assign {% data variables.product.prodname_vs %} Licenses in the {% data variables.product.prodname_vs %} Subscriptions Administration Portal in Microsoft Docs.

3. Optionally, if the subscription admin assigned licenses to subscribers in {% data variables.product.prodname_vs %} before adding {% data variables.product.prodname_enterprise %} to the subscription, the subscription admin can move the subscribers to the combined offering in the {% data variables.product.prodname_vs %} administration portal. For more information, see Manage {% data variables.product.prodname_vs %} subscriptions with {% data variables.product.prodname_enterprise %} in Microsoft Docs.

4. If the subscription admin has not disabled email notifications, the subscriber will receive two confirmation emails. For more information, see {% data variables.product.prodname_vs %} subscriptions with {% data variables.product.prodname_enterprise %} in Microsoft Docs.

5. An organization owner must invite the subscriber to the organization on {% data variables.location.product_location %} from step 1. The subscriber can accept the invitation with an existing personal account on {% data variables.product.prodname_dotcom_the_website %} or create a new account. After the subscriber joins the organization, the subscriber becomes an enterprise member. For more information, see "AUTOTITLE."

   {% tip %}

   Tips:

   • While not required, we recommend that the organization owner sends an invitation to the same email address used for the subscriber's User Primary Name (UPN). When the email address on {% data variables.location.product_location %} matches the subscriber's UPN, you can ensure that another enterprise does not claim the subscriber's license.
   • If the subscriber accepts the invitation to the organization with an existing personal account on {% data variables.location.product_location %}, we recommend that the subscriber add the email address they use for {% data variables.product.prodname_vs %} to their personal account on {% data variables.location.product_location %}. For more information, see "AUTOTITLE."
   • If the organization owner must invite a large number of subscribers, a script may make the process faster. For more information, see the sample PowerShell script in the github/platform-samples repository.

   {% endtip %}

After {% data variables.visual_studio.prodname_vss_ghe %} is set up for subscribers on your team, enterprise owners can review licensing information on {% data variables.location.product_location %}. For more information, see "AUTOTITLE."

Further reading

• "AUTOTITLE"