<aside> 🔑 This page explains how to create and maintain license keys for prospects and customers.

</aside>

<aside> 🆕 2024-08-14: Subscription and license management was recently refreshed with an updated UI and new features, backed by a new service called Enterprise Portal, developed by Core Services team - please see the Slack announcement.

An introductory Loom video is also available that goes over some of the major changes: https://www.loom.com/share/8560388e0a4a404caf67d908820ed0d0

If you have any questions or feedback, please reach out to #discuss-core-services!

</aside>

• Creating a new license key walkthrough
• Enterprise Subscription modelling in Enterprise Portal

Licensing Overview

Sourcegraph requires site administrators to apply a license key to access to various paid features. License keys are created and managed via the Site-admin > Enterprise subscriptions page on sourcegraph.com/search:

• Enterprise subscriptions
• Enterprise license key lookup

You will need to request permissions to view these pages: please refer to Accessing Site Admin.

<aside> 🚨 Please read Enterprise Subscription modelling in Enterprise Portal first to get an understanding of how Enterprise Subscriptions are modelled in our Enterprise Portal system. This is critical to maintain internal integrations with Enterprise customers.

In particular, note that every Enterprise subscription must correspond to exactly one Sourcegraph instance - there should never be licenses for multiple Sourcegraph instances within a single Enterprise subscription. If you have licenses for multiple instances in a single subscription, please reach out to #discuss-core-services for assistance in re-linking existing licenses to new Enterprise subscriptions.

</aside>

<aside> 🚨

When working with customer subscriptions and licenses, DO NOT USE the Enterprise Portal “development” environment, which is only meant for internal development use. In other words, ALWAYS ENSURE the “✅ Production” option is selected in the dropdown on subscription management web pages.

</aside>

Accessing Site Admin

License keys can only be generated by site administrators on sourcegraph.com. To create or maintain a license you must request temporary access via Entitle (in Okta). Entitle grants temporary access to site admin.

1. Go to Entitle via Okta
2. Search for dotcom site-admin and select dotcom site-admin. Access is logged but automatically provisioned.
3. If you are logged in to your dotcom account, reload the page so that your account updates to site-admin permissions.
   • NOTE: If you do not see site-admin permissions, check your profile settings -> Emails section and ensure that your sourcegraph.com email address is added to your profile, verified and it is set as primary. Or you can logout and login using Google Authentication into dotcom, this will create a new account for you with your sourcegraph.com email attached to it.
4. On the top right click on your profile icon and the site admin menu will now be available for you to access.
5. Go to Enterprise subscriptions.