Uploading a new license to GitHub Enterprise Server

You can upload your license file for GitHub Enterprise to your GitHub Enterprise Server instance to validate your application.

In this article

About license files for GitHub Enterprise

After you purchase or upgrade a license for GitHub Enterprise from GitHub's Sales team, you must upload the new license file to your GitHub Enterprise Server instance to unlock your new user licenses. For more information, see About licenses for GitHub Enterprise and Downloading your license for GitHub Enterprise.

If you'd like to renew or add user licenses to GitHub Enterprise, or if you have questions about your license, contact GitHub's Sales team. Your new license file will be available for download immediately after you complete your order.

Uploading your license from the Management Console

  1. Sign into your GitHub Enterprise Server instance as a site administrator.

  2. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the dropdown menu shown when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is outlined.

  3. At the top of the page, click Settings.

  4. Under Settings, click License.

  5. In the "User licenses" section, under "Quick links", click Update license.

    Screenshot of the "User licenses" section of the "License" page. A link, labeled "Update license", is outlined in dark orange.

  6. To upload your license, click License file, or drag your license file onto License file.

    Screenshot of the "License" page of the Management Console. A link, labeled "License file", is highlighted with an orange outline.

  7. Click Upload. Your license will be updated in the background. The change may take a few minutes before it is visible on your instance.

Uploading your license with the REST API

You can use the REST API to upload a license to your GitHub Enterprise Server instance. See REST API endpoints for managing GitHub Enterprise Server.

Uploading a license with the GitHub CLI

You can import a license to your GitHub Enterprise Server instance using the gh es extension of the GitHub CLI. See the usage instructions in the github/gh-es repository on GitHub.com.

For more information about accessing your instance via the extension, see Administering your instance using the GitHub CLI.

Uploading a license via SSH

You can upload and interact with your license from the command line via SSH. See the documentation for the ghe-license command in Command-line utilities. For more information about accessing your instance via SSH, see Accessing the administrative shell (SSH).