Licensing

Sourcegraph Enterprise requires a valid license key to enable many Enterprise-specific features.

Sourcegraph will periodically perform a license validation check by contacting sourcegraph.com. This check sends no information other than a unique site ID and information about the configured Sourcegraph license. This check is mandatory, and if the check fails Sourcegraph will disable all Enterprise features until a successful license check is completed.

Sourcegraph 5.1+

If Sourcegraph needs to operate in an air-gapped environment without an external internet connection, contact customer support for a special license key.

License keys also need to be unique to a single instance of Sourcegraph. If the same license key is used across multiple instances, subsequent license checks will fail. If multiple license keys are required for dev/staging instances, contact customer support for additional license keys for these instances.

How to update your license key

Any current Site Admin can update your license key by going to Site Admin -> Site configuration

These settings live in the JSON object, and you will need to navigate to the licenseKey section of that object.

Update the value of this with your new license key and click Save to apply your changes.

Example:

  "licenseKey": "<your_key_here>",

Upgrading to Sourcegraph 5.1

When upgrading to Sourcegraph 5.1 while using the same license key on multiple instances (e.g. dev and prod), the first instance to be upgraded will claim the license key.

When the second instance is upgraded while using the same license key, license verification will fail for that instance. Please make sure to contact customer support and request a new license key, so that different Sourcegraph instances all have unique license keys.

FAQ

We have set up a new Sourcegraph instance by replicating an existing instance, how can we generate a new site ID to ensure the instances are unique?

The site ID of a Sourcegraph instance can be updated by running the following SQL query against the database:

UPDATE global_state SET site_id = gen_random_uuid();

You will still require a unique license key for each site ID.