@@ -254,7 +254,7 @@ To subscribe to GitLab through a GitLab self-managed installation:
...
@@ -254,7 +254,7 @@ To subscribe to GitLab through a GitLab self-managed installation:
1. Go to the [Customers Portal](https://customers.gitlab.com/) and purchase a GitLab self-managed plan.
1. Go to the [Customers Portal](https://customers.gitlab.com/) and purchase a GitLab self-managed plan.
1. After purchase, a license file is sent to the email address associated to the Customers Portal account,
1. After purchase, a license file is sent to the email address associated to the Customers Portal account,
which must be [uploaded to your GitLab instance](../../user/admin_area/license.md#uploading-your-license).
which must be [uploaded to your GitLab instance](../../user/admin_area/license.md#upload-your-license).
NOTE:
NOTE:
If you're purchasing a subscription for an existing **Free** GitLab self-managed
If you're purchasing a subscription for an existing **Free** GitLab self-managed
...
@@ -373,7 +373,7 @@ To add seats to a subscription:
...
@@ -373,7 +373,7 @@ To add seats to a subscription:
The following items are emailed to you:
The following items are emailed to you:
- A payment receipt. You can also access this information in the Customers Portal under [**View invoices**](https://customers.gitlab.com/receipts).
- A payment receipt. You can also access this information in the Customers Portal under [**View invoices**](https://customers.gitlab.com/receipts).
- A new license. [Upload this license](../../user/admin_area/license.md#uploading-your-license) to your instance to use it.
- A new license. [Upload this license](../../user/admin_area/license.md#upload-your-license) to your instance to use it.
### Renew a subscription
### Renew a subscription
...
@@ -394,7 +394,7 @@ You can hover your mouse on the **Renew** button to see the date when it will be
...
@@ -394,7 +394,7 @@ You can hover your mouse on the **Renew** button to see the date when it will be
1. Enter the number of [users over license](#users-over-license) in the second box for the user overage incurred in your previous subscription term.
1. Enter the number of [users over license](#users-over-license) in the second box for the user overage incurred in your previous subscription term.
1. Review your renewal details and complete the payment process.
1. Review your renewal details and complete the payment process.
1. A license for the renewal term is available for download on the [Manage Purchases](https://customers.gitlab.com/subscriptions) page on the relevant subscription card. Select **Copy license to clipboard** or **Download license** to get a copy.
1. A license for the renewal term is available for download on the [Manage Purchases](https://customers.gitlab.com/subscriptions) page on the relevant subscription card. Select **Copy license to clipboard** or **Download license** to get a copy.
1.[Upload](../../user/admin_area/license.md#uploading-your-license) your new license to your instance.
1.[Upload](../../user/admin_area/license.md#upload-your-license) your new license to your instance.
An invoice is generated for the renewal and available for viewing or download on the [View invoices](https://customers.gitlab.com/receipts) page. If you have difficulty during the renewal process, contact our [support team](https://support.gitlab.com/hc/en-us/requests/new?ticket_form_id=360000071293) for assistance.
An invoice is generated for the renewal and available for viewing or download on the [View invoices](https://customers.gitlab.com/receipts) page. If you have difficulty during the renewal process, contact our [support team](https://support.gitlab.com/hc/en-us/requests/new?ticket_form_id=360000071293) for assistance.
...
@@ -416,7 +416,7 @@ The following is emailed to you:
...
@@ -416,7 +416,7 @@ The following is emailed to you:
@@ -42,38 +42,30 @@ To activate your instance with an activation code:
...
@@ -42,38 +42,30 @@ To activate your instance with an activation code:
1. Read and accept the terms of service.
1. Read and accept the terms of service.
1. Select **Activate**.
1. Select **Activate**.
## Activate GitLab EE with a License File
## Activate GitLab EE with a license file
If you receive a license file from GitLab (for example a new trial), you can upload it by signing into your GitLab instance as an administrator or adding it during installation. The license is a base64-encoded ASCII text file with a `.gitlab-license` extension.
If you receive a license file from GitLab (for example, for a trial), you can
upload it to your instance or add it during installation. The license file is
a base64-encoded ASCII text file with a `.gitlab-license` extension.
## Uploading your license
## Upload your license
The first time you visit your GitLab EE installation signed in as an administrator,
The first time you sign in to your GitLab instance, a note with a
you should see a note urging you to upload a license with a link that takes you
link to the **Upload license** page should be displayed.
to the **Upload license** page.
Otherwise, to manually go to the **Upload license** page:
Otherwise, to upload your license:
1. Sign in to your GitLab self-managed instance.
1. Sign in to GitLab as an administrator.
1.From the top menu, select the Admin Area **{admin}**.
1.On the top bar, select **Menu > Admin**.
1. On the left sidebar, select **Settings**.
1. On the left sidebar, select **Settings**.
1. In the **License file** section, select **Upload a license**.
1. In the **License file** area, select **Upload a license**.
1. Upload a license:
-*If you've received a `.gitlab-license` file:*
- For a file, select **Upload `.gitlab-license` file**, **Choose file**, and
1. Download the license file to your local machine.
select the license file from your local machine.
1. Select **Upload `.gitlab-license` file**.
- For plain text, select **Enter license key** and paste the contents in
1. Select **Choose file** and select the license file.
**License key**.
In this example the license file is named `GitLab.gitlab-license`.
1. Select the **Terms of Service** checkbox.
1. Select the **Terms of Service** checkbox.
1. Select **Upload License**.
1. Select **Upload License**.
![Upload license](img/license_upload_v13_12.png)
-*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. Select the **Terms of Service** checkbox.
1. Select **Upload License**.
## Add your license during installation
## Add your license during installation
...
@@ -110,7 +102,7 @@ and issue creation. Your instance becomes read-only and
...
@@ -110,7 +102,7 @@ and issue creation. Your instance becomes read-only and
an expiration message displays to all administrators. You have a 14-day grace period
an expiration message displays to all administrators. You have a 14-day grace period
before this occurs.
before this occurs.
To resume functionality, [upload a new license](#uploading-your-license).
To resume functionality, [upload a new license](#upload-your-license).
To go back to Free features, [delete all expired licenses](#remove-a-license-file).
To go back to Free features, [delete all expired licenses](#remove-a-license-file).