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 about licenses for GitHub Enterprise Server, 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 to your GitHub Enterprise Server instance
Warning: Updating your license causes a small amount of downtime for your GitHub Enterprise Server instance.
-
Sign into your GitHub Enterprise Server instance as a site administrator.
-
In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.
-
In the enterprise account sidebar, click Settings.
-
In the left sidebar, click License.
-
Under "Quick links", click Update license.
-
To select your license, click License file, or drag your license file onto License file.
-
Click Upload.
If the web UI for GitHub Enterprise Server doesn't reflect your updated license immediately, see "Troubleshooting."
Troubleshooting
In some scenarios, the web UI for GitHub Enterprise Server may not immediately reflect your new license. You can force the system to detect the license by restarting two system services.
-
SSH into your GitHub Enterprise Server instance. For more information, see "Accessing the administrative shell (SSH)."
$ ssh -p 122 admin@HOSTNAME
-
Restart the services for Git authentication and the HTTP server.
Warning: Running the following command will result in a few minutes of user-facing downtime for GitHub Enterprise Server. Run the command with care.
sudo systemctl restart github-gitauth github-unicorn
-
After GitHub Enterprise Server returns you to a prompt, try accessing GitHub Enterprise Server via the command line or web UI again.