- Uploading your license
- Add your license at install time
- Notification before the license expires
- What happens when your license expires
- License history
To activate all GitLab Enterprise Edition (EE) functionality, you need to upload a license. After you’ve received your license from GitLab Inc., you can upload it by signing into your GitLab instance as an admin or adding it at installation time.
As of GitLab Enterprise Edition 9.4.0, a newly-installed instance without an uploaded license only has the Core features active. A trial license activates all Ultimate features, but after the trial expires, some functionality is locked.
The very first time you visit your GitLab EE installation signed in as an admin, you should see a note urging you to upload a license with a link that takes you to Admin Area > License.
Otherwise, you can:
Navigate manually to the Admin Area by clicking the wrench () icon in the menu bar.
Navigate to the License tab, and click Upload New License.
If you’ve received a
.gitlab-licensefile, you should have already downloaded it in your local machine. You can then upload it directly by choosing the license file and clicking the Upload license button. In the image below, the selected license file is named
If you’ve received your license as plain text, select the Enter license key option, copy the license, paste it into the License key field, and click Upload license.
A license can be automatically imported at install time by placing a file named
/etc/gitlab/ for Omnibus GitLab, or
config/ for source installations.
You can also specify a custom location and filename for the license:
Source installations should set the
GITLAB_LICENSE_FILEenvironment variable with the path to a valid GitLab Enterprise Edition license.
Omnibus GitLab installations should add this entry to
gitlab_rails['initial_license_file'] = "/path/to/license/file"
After the license is uploaded, all GitLab Enterprise Edition functionality is active until the end of the license period. When that period ends, the instance will fall back to Core-only functionality.
You can review the license details at any time in the License section of the Admin Area.
One month before the license expires, a message informing about the expiration date is displayed to GitLab admins. Make sure that you update your license, otherwise you miss all the paid features if your license expires.
In case your license expires, GitLab locks down some features like Git pushes, and issue creation, and displays a message to all admins to inform of the expired license.
To get back all the previous functionality, you must upload a new license. To fall back to having only the Core features active, you must delete the expired license(s).
To remove a license from a self-managed instance:
- In the top navigation bar, click the wrench icon to navigate to the Admin Area.
- Click License in the left sidebar.
- Click Remove License.
You can upload and view more than one license, but only the latest license is used as the active license.
If you originally installed Community Edition rather than Enterprise Edition you must upgrade to Enterprise Edition before uploading your license.
GitLab.com users can’t upload and use a self-managed license. If you want to use paid features on GitLab.com, you can purchase a separate subscription.
If you’ve added new users to your GitLab instance prior to renewal, you may need to purchase additional seats to cover those users. If this is the case, and a license without enough users is uploaded, GitLab displays a message prompting you to purchase additional users. More information on how to determine the required number of users and how to add additional seats can be found in the licensing FAQ.