debian-mirror-gitlab/doc/user/admin_area/license.md

151 lines
6.3 KiB
Markdown
Raw Normal View History

2019-09-04 21:01:54 +05:30
---
2020-06-23 00:09:42 +05:30
stage: Growth
group: Conversion
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2019-09-04 21:01:54 +05:30
type: howto
---
2020-07-28 23:09:34 +05:30
# Activate GitLab EE with a license **(STARTER ONLY)**
2019-07-31 22:56:46 +05:30
To activate all GitLab Enterprise Edition (EE) functionality, you need to upload
2021-01-29 00:20:46 +05:30
a license. It's only possible to activate GitLab Enterprise Edition, so first verify which edition
you are running. To verify, sign in to GitLab and browse to `/help`. The GitLab edition and version
are listed at the top of the **Help** page.
If you are running GitLab Community Edition (CE), upgrade your installation to
2021-03-11 19:13:27 +05:30
GitLab Enterprise Edition (EE). For more details, see [Upgrading between editions](../../update/index.md#upgrading-between-editions).
2021-01-29 00:20:46 +05:30
If you have questions or need assistance upgrading from GitLab CE to EE please [contact GitLab Support](https://about.gitlab.com/support/#contact-support).
2019-07-31 22:56:46 +05:30
2021-01-03 14:25:43 +05:30
The license is a base64-encoded ASCII text file with a `.gitlab-license`
extension. You can obtain the file by [purchasing a license](https://about.gitlab.com/pricing/)
or by signing up for a [free trial](https://about.gitlab.com/free-trial/).
2019-07-31 22:56:46 +05:30
2021-01-29 00:20:46 +05:30
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.
2019-07-31 22:56:46 +05:30
As of GitLab Enterprise Edition 9.4.0, a newly-installed instance without an
2021-03-11 19:13:27 +05:30
uploaded license only has the Free features active. A trial license
2021-01-03 14:25:43 +05:30
activates all Ultimate features, but after
2019-07-31 22:56:46 +05:30
[the trial expires](#what-happens-when-your-license-expires), some functionality
2021-01-03 14:25:43 +05:30
is locked.
2019-07-31 22:56:46 +05:30
## Uploading your license
2021-03-08 18:12:59 +05:30
The first time you visit your GitLab EE installation signed in as an administrator,
2019-07-31 22:56:46 +05:30
you should see a note urging you to upload a license with a link that takes you
2021-01-03 14:25:43 +05:30
to **Admin Area > License**.
2019-07-31 22:56:46 +05:30
Otherwise, you can:
2021-01-03 14:25:43 +05:30
1. Navigate manually to the **Admin Area** by clicking the wrench (**{admin}**) icon in the menu bar.
2019-07-31 22:56:46 +05:30
2021-01-03 14:25:43 +05:30
1. Navigate to the **License** tab, and click **Upload New License**.
2019-07-31 22:56:46 +05:30
2021-03-08 18:12:59 +05:30
- *If you've received a `.gitlab-license` file:*
1. Download the license file to your local machine.
1. Select **Upload `.gitlab-license` file**.
1. Select **Choose File** and select the license file.
In this example the license file is named `GitLab.gitlab-license`.
1. Check the **Subscription Agreement** checkbox.
1. Select **Upload License**.
2019-07-31 22:56:46 +05:30
2021-03-08 18:12:59 +05:30
![Upload license](img/license_upload_v13_8.png)
2019-07-31 22:56:46 +05:30
2021-03-08 18:12:59 +05:30
- *If you've received your license as plain text:*
1. Select **Enter license key**.
1. Copy the license and paste it into the **License key** field.
1. Check the **Subscription Agreement** checkbox.
1. Select **Upload License**.
2019-07-31 22:56:46 +05:30
## Add your license at install time
2021-01-03 14:25:43 +05:30
A license can be automatically imported at install time by placing a file named
`Gitlab.gitlab-license` in `/etc/gitlab/` for Omnibus GitLab, or `config/` for source installations.
2019-07-31 22:56:46 +05:30
2021-01-03 14:25:43 +05:30
You can also specify a custom location and filename for the license:
2019-07-31 22:56:46 +05:30
2021-01-03 14:25:43 +05:30
- Source installations should set the `GITLAB_LICENSE_FILE` environment
variable with the path to a valid GitLab Enterprise Edition license.
2019-07-31 22:56:46 +05:30
2021-01-03 14:25:43 +05:30
```shell
export GITLAB_LICENSE_FILE="/path/to/license/file"
```
2019-07-31 22:56:46 +05:30
2021-01-03 14:25:43 +05:30
- Omnibus GitLab installations should add this entry to `gitlab.rb`:
2019-07-31 22:56:46 +05:30
2021-01-03 14:25:43 +05:30
```ruby
gitlab_rails['initial_license_file'] = "/path/to/license/file"
```
2019-07-31 22:56:46 +05:30
2021-02-22 17:27:13 +05:30
WARNING:
2021-01-03 14:25:43 +05:30
These methods only add a license at the time of installation. Use the
**{admin}** **Admin Area** in the web user interface to renew or upgrade licenses.
2019-07-31 22:56:46 +05:30
---
2021-01-03 14:25:43 +05:30
After the license is uploaded, all GitLab Enterprise Edition functionality
is active until the end of the license period. When that period ends, the
2021-03-11 19:13:27 +05:30
instance will [fall back](#what-happens-when-your-license-expires) to Free-only
2019-07-31 22:56:46 +05:30
functionality.
2021-01-03 14:25:43 +05:30
You can review the license details at any time in the **License** section of the
**Admin Area**.
2019-07-31 22:56:46 +05:30
2021-03-11 19:13:27 +05:30
![License details](img/license_details_v13_8.png)
2019-07-31 22:56:46 +05:30
## Notification before the license expires
2021-01-03 14:25:43 +05:30
One month before the license expires, a message informing about the expiration
2021-02-22 17:27:13 +05:30
date is displayed to GitLab administrators. Make sure that you update your
2021-01-03 14:25:43 +05:30
license, otherwise you miss all the paid features if your license expires.
2019-07-31 22:56:46 +05:30
## What happens when your license expires
2021-01-03 14:25:43 +05:30
In case your license expires, GitLab locks down some features like Git pushes,
2021-02-22 17:27:13 +05:30
and issue creation, and displays a message to all administrators to inform of the expired license.
2019-07-31 22:56:46 +05:30
2021-01-03 14:25:43 +05:30
To get back all the previous functionality, you must upload a new license.
2021-03-11 19:13:27 +05:30
To fall back to having only the Free features active, you must delete the
2019-07-31 22:56:46 +05:30
expired license(s).
2020-10-24 23:57:45 +05:30
### Remove a license
To remove a license from a self-managed instance:
2021-01-03 14:25:43 +05:30
1. In the top navigation bar, click the **{admin}** wrench icon to navigate to the [Admin Area](index.md).
2020-10-24 23:57:45 +05:30
1. Click **License** in the left sidebar.
1. Click **Remove License**.
2019-07-31 22:56:46 +05:30
## License history
2021-01-29 00:20:46 +05:30
You can upload and view more than one license, but only the latest license in the current date
range is used as the active license. When you upload a future-dated license, it
doesn't take effect until its applicable date.
2019-07-31 22:56:46 +05:30
2021-03-08 18:12:59 +05:30
NOTE:
In GitLab 13.6 and earlier, a notification banner about an expiring license may continue to be displayed even after a new license has been uploaded.
This happens when the newly uploaded license's start date is in the future and the expiring one is still active.
The banner disappears after the new license becomes active.
2020-07-28 23:09:34 +05:30
## Troubleshooting
2019-09-04 21:01:54 +05:30
2020-07-28 23:09:34 +05:30
### There is no License tab in the Admin Area
2019-09-04 21:01:54 +05:30
2021-01-03 14:25:43 +05:30
If you originally installed Community Edition rather than Enterprise Edition you must
2021-03-11 19:13:27 +05:30
[upgrade to Enterprise Edition](../../update/index.md#community-to-enterprise-edition)
2020-07-28 23:09:34 +05:30
before uploading your license.
2021-01-03 14:25:43 +05:30
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](../../subscriptions/gitlab_com/index.md).
2020-07-28 23:09:34 +05:30
### Users exceed license limit upon renewal
2021-01-03 14:25:43 +05:30
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
2020-07-28 23:09:34 +05:30
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](https://about.gitlab.com/pricing/licensing-faq/).