Cloud Licensing allows GitLab customers to activate paid subscription features on self-managed instances using an activation code, rather than managing license files and manually uploading them to instances. This licensing method was first introduced in August 2021 and became the default activation method for Self Managed customers in July 2022. By activating through Cloud Licensing, a customer’s GitLab instance will synchronize subscription data daily with GitLab.
These regular synchronizations of usage data enable GitLab to better support you as you grow, and provides you with a simpler and more efficient billing and subscription management experience for subscription overages reconciliation, mid-term add ons, and renewals.
GitLab is moving away from license files so that we can more efficiently support you and your company's growth. Cloud Licensing provides:
Cloud Licensing is made up of two parts:
The data transmitted is limited to what is necessary to administer a GitLab license and support future renewals, add ons, and seat reconciliation. The data does not include any intellectual property, source code, or user personal information except the name, company name, and email address of the administrator account associated with the subscription, which are all encrypted within the License Key. No fields can be excluded from what is transmitted.
For the exact list of data fields included in License Sync, please refer to our Subscription Data documentation.
Cloud Licensing is available to all GitLab Self Managed customers – both those who work with GitLab directly, and those who work indirectly through a Channel or Alliances partner, regardless of payment or contract method. Cloud Licensing is not currently available for Education, Open Source, Startup, or Free Tier customers.
To use Cloud Licensing, you must be on GitLab version 14.1 or higher and have an internet connection. If you are not yet on version 14.1, you can upgrade your instance to take advantage of the benefits of Cloud Licensing. You may also be unable to use Cloud Licensing if your instance is blocked by a firewall. If you are unable to apply an activation code you received to your instance, please contact our Support team for troubleshooting or to receive a legacy license file.
If you purchase(d) a new or renewal GitLab Self Managed subscription after July 2022, you can access your Cloud License activation code in your initial purchase email or from the Customers Portal. You can review our documentation for further details on how to activate your instance with an activation code.
If you are an existing customer using a legacy license file, you can activate Cloud Licensing mid-term - no need to wait for a renewal!
For customers with an offline or air-gapped instance on GitLab version 15.0 or higher who want to take advantage of the benefits of Cloud Licensing, an Offline Cloud License may be an option on an approval-only basis. Offline Cloud Licenses offer an alternative to online License Sync by requesting you to manually provide usage data to GitLab on a monthly basis. Offline Cloud Licenses can help with smoother renewals and add-ons by providing GitLab with insight into the current state of a subscription, but does not support automated syncs of additional purchases given the lack of internet connectivity. Additional license files will be required.
If you have been approved for an Offline Cloud License, you will receive your license file via email. If you purchased from GitLab directly, you can also access your Offline license from the Customers Portal.
Once you upload your license file to your instance, you will receive monthly email reminders (sent to the account's Sold To
contact) and in-app banners (visible to all instance admins) to export your usage data and email it to renewals-service@customers.gitlab.com
. Exported usage data files include the same data fields as a Cloud License online sync and help GitLab to understand the current state of your subscription. When we receive this data, we automatically match against the file’s contents (not on the From
email address) to ensure this data is stored correctly. Mime-types of 'application/octet-stream'
, 'text/csv'
and 'application/vnd.ms-excel'
are supported for shared usage files.
The in-app reminder banners will appear until an admin completes the export of data, at which point they become dismissable and will not be displayed again until the following month. If usage data is not shared monthly while on an Offline Cloud License, GitLab will not have any insight into your current usage, which can complicate additional purchases and the renewal process. However, you will not be at risk of any downgrades or other impacts to your instance.
If you are interested in Offline Cloud Licensing, please reach out to your account manager to understand if you may be a candidate.
When you visit any website, it may store or retrieve information on your browser, mostly in the form of cookies. This information might be about you, your preferences or your device and is mostly used to make the site work as you expect it to. The information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies. Click on the different category headings to find out more and change our default settings. However, blocking some types of cookies may impact your experience of the site and the services we are able to offer.
Cookie Policy
These cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by you which amount to a request for services, such as setting your privacy preferences, enabling you to securely log into the site, filling in forms, or using the customer checkout. GitLab processes any personal data collected through these cookies on the basis of our legitimate interest.
These cookies enable helpful but non-essential website functions that improve your website experience. By recognizing you when you return to our website, they may, for example, allow us to personalize our content for you or remember your preferences. If you do not allow these cookies then some or all of these services may not function properly. GitLab processes any personal data collected through these cookies on the basis of your consent
These cookies allow us and our third-party service providers to recognize and count the number of visitors on our websites and to see how visitors move around our websites when they are using it. This helps us improve our products and ensures that users can easily find what they need on our websites. These cookies usually generate aggregate statistics that are not associated with an individual. To the extent any personal data is collected through these cookies, GitLab processes that data on the basis of your consent.
These cookies enable different advertising related functions. They may allow us to record information about your visit to our websites, such as pages visited, links followed, and videos viewed so we can make our websites and the advertising displayed on it more relevant to your interests. They may be set through our website by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant advertisements on other websites. GitLab processes any personal data collected through these cookies on the basis of your consent.