debian-mirror-gitlab/doc/subscriptions/gitlab_com/index.md

391 lines
18 KiB
Markdown
Raw Normal View History

2020-11-24 15:15:51 +05:30
---
2021-03-08 18:12:59 +05:30
stage: Fulfillment
group: Purchase
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
2020-11-24 15:15:51 +05:30
type: index, reference
---
2021-03-11 19:13:27 +05:30
# GitLab SaaS subscription **(PREMIUM SAAS)**
2020-11-24 15:15:51 +05:30
2021-09-30 23:02:18 +05:30
GitLab SaaS is the GitLab software-as-a-service offering, which is available at GitLab.com.
You don't need to install anything to use GitLab SaaS, you only need to
2021-11-18 22:05:49 +05:30
[sign up](https://gitlab.com/users/sign_up). When you sign up, you choose:
2020-11-24 15:15:51 +05:30
2022-03-02 08:16:31 +05:30
- [A subscription](https://about.gitlab.com/pricing/).
2021-11-18 22:05:49 +05:30
- [The number of seats you want](#how-seat-usage-is-determined).
2020-11-24 15:15:51 +05:30
2022-04-04 11:22:00 +05:30
The subscription determines which features are available for your private projects. Organizations with public open source projects can actively apply to our [GitLab for Open Source Program](https://about.gitlab.com/solutions/open-source/join/).
2022-03-02 08:16:31 +05:30
Qualifying open source projects also get 50,000 CI/CD minutes and free access to the **Ultimate** tier
2021-11-18 22:05:49 +05:30
through the [GitLab for Open Source program](https://about.gitlab.com/solutions/open-source/).
2020-11-24 15:15:51 +05:30
2021-03-11 19:13:27 +05:30
## Obtain a GitLab SaaS subscription
2022-03-02 08:16:31 +05:30
A GitLab SaaS subscription applies to a top-level group.
Members of every subgroup and project in the group:
- Can use the features of the subscription.
- Consume seats in the subscription.
2021-03-11 19:13:27 +05:30
To subscribe to GitLab SaaS:
2021-11-18 22:05:49 +05:30
1. View the [GitLab SaaS feature comparison](https://about.gitlab.com/pricing/gitlab-com/feature-comparison/)
and decide which tier you want.
1. Create a user account for yourself by using the
2021-03-11 19:13:27 +05:30
[sign up page](https://gitlab.com/users/sign_up).
2022-08-27 11:52:29 +05:30
1. Create a [group](../../user/group/manage.md#create-a-group). Your subscription tier applies to the top-level group, its subgroups, and projects.
2021-03-11 19:13:27 +05:30
1. Create additional users and
2022-08-27 11:52:29 +05:30
[add them to the group](../../user/group/manage.md#add-users-to-a-group). The users in this group, its subgroups, and projects can use
the features of your subscription tier, and they consume a seat in your subscription.
2021-11-18 22:05:49 +05:30
1. On the left sidebar, select **Billing** and choose a tier.
1. Fill out the form to complete your purchase.
2020-11-24 15:15:51 +05:30
2021-03-11 19:13:27 +05:30
## View your GitLab SaaS subscription
2020-11-24 15:15:51 +05:30
2021-11-18 22:05:49 +05:30
Prerequisite:
2022-04-04 11:22:00 +05:30
- You must have the Owner role for the group.
2020-11-24 15:15:51 +05:30
2021-11-18 22:05:49 +05:30
To see the status of your GitLab SaaS subscription:
1. On the top bar, select **Menu > Groups** and find your group.
1. On the left sidebar, select **Settings > Billing**.
2020-11-24 15:15:51 +05:30
2021-11-18 22:05:49 +05:30
The following information is displayed:
2020-11-24 15:15:51 +05:30
2021-03-11 19:13:27 +05:30
| Field | Description |
|:----------------------------|:------------|
| **Seats in subscription** | If this is a paid plan, represents the number of seats you've bought for this group. |
2021-11-18 22:05:49 +05:30
| **Seats currently in use** | Number of seats in use. Select **See usage** to see a list of the users using these seats. |
2021-03-11 19:13:27 +05:30
| **Max seats used** | Highest number of seats you've used. |
2021-11-18 22:05:49 +05:30
| **Seats owed** | **Max seats used** minus **Seats in subscription**. |
2021-03-11 19:13:27 +05:30
| **Subscription start date** | Date your subscription started. If this is for a Free plan, it's the date you transitioned off your group's paid plan. |
| **Subscription end date** | Date your current subscription ends. Does not apply to Free plans. |
2021-03-08 18:12:59 +05:30
2021-11-18 22:05:49 +05:30
## How seat usage is determined
2021-03-08 18:12:59 +05:30
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/216899) in GitLab 13.5.
> - [Updated](https://gitlab.com/gitlab-org/gitlab/-/issues/292086) in GitLab 13.8 to include public
email address.
2021-11-18 22:05:49 +05:30
A GitLab SaaS subscription uses a concurrent (_seat_) model. You pay for a
2022-03-02 08:16:31 +05:30
subscription according to the maximum number of users assigned to the top-level group or its children during the billing period. You can
2021-11-18 22:05:49 +05:30
add and remove users during the subscription period, as long as the total users
at any given time doesn't exceed the subscription count.
2021-03-08 18:12:59 +05:30
2022-08-27 11:52:29 +05:30
A top-level group can be [changed](../../user/group/manage.md#change-a-groups-path) like any other group.
2022-03-02 08:16:31 +05:30
2021-11-11 11:23:49 +05:30
Every user is included in seat usage, with the following exceptions:
- Users who are pending approval.
- Members with the Guest role on an Ultimate subscription.
2022-04-04 11:22:00 +05:30
- GitLab-created service accounts:
- [Ghost User](../../user/profile/account/delete_account.md#associated-records).
- Bots such as:
- [Support Bot](../../user/project/service_desk.md#support-bot-user).
- [Bot users for projects](../../user/project/settings/project_access_tokens.md#bot-users-for-projects).
- [Bot users for groups](../../user/group/settings/group_access_tokens.md#bot-users-for-groups).
2021-11-11 11:23:49 +05:30
2021-11-18 22:05:49 +05:30
Seat usage is reviewed [quarterly or annually](../quarterly_reconciliation.md).
2022-03-02 08:16:31 +05:30
If a user navigates to a different top-level group (one they have created themselves, for example)
and that group does not have a paid subscription, they would not see any of the paid features.
It is also possible for users to belong to two different top-level groups with different subscriptions.
In this case, they would see only the features available to that subscription.
2021-11-11 11:23:49 +05:30
### View seat usage
To view a list of seats being used:
1. On the top bar, select **Menu > Groups** and find your group.
1. On the left sidebar, select **Settings > Usage Quotas**.
2021-11-18 22:05:49 +05:30
1. On the **Seats** tab, view usage information.
The seat usage listing is updated live, but the usage statistics on the billing page are updated
only once per day. For this reason there can be a minor difference between the seat usage listing
and the billing page.
2021-11-11 11:23:49 +05:30
2021-03-08 18:12:59 +05:30
### Search seat usage
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/262875) in GitLab 13.8.
To search users in the **Seat usage** page, enter a string in the search field. A minimum of 3
characters are required.
The search returns those users whose first name, last name, or username contain the search string.
For example:
| First name | Search string | Match ? |
|:-----------|:--------------|:--------|
| Amir | `ami` | Yes |
| Amir | `amr` | No |
2020-11-24 15:15:51 +05:30
2021-10-27 15:23:28 +05:30
### Export seat usage
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/262877) in GitLab 14.2.
To export seat usage data as a CSV file:
1. On the top bar, select **Menu > Groups** and find your group.
1. On the left sidebar, select **Settings > Billing**.
1. Under **Seats currently in use**, select **See usage**.
1. Select **Export list**.
The generated list contains all seats being used,
and is not affected by the current search.
2021-11-18 22:05:49 +05:30
## Seats owed
2021-04-29 21:17:54 +05:30
2021-11-18 22:05:49 +05:30
A GitLab subscription is valid for a specific number of users.
2021-04-29 21:17:54 +05:30
2021-11-18 22:05:49 +05:30
If the number of billable users exceeds the number included in the subscription, known
2022-03-02 08:16:31 +05:30
as the number of **seats owed**, you must pay for the excess number of users.
2021-04-29 21:17:54 +05:30
2021-11-18 22:05:49 +05:30
For example, if you purchase a subscription for 10 users:
2021-04-29 21:17:54 +05:30
| Event | Billable members | Maximum users |
|:---------------------------------------------------|:-----------------|:--------------|
| Ten users occupy all 10 seats. | 10 | 10 |
| Two new users join. | 12 | 12 |
| Three users leave and their accounts are removed. | 9 | 12 |
Seats owed = 12 - 10 (Maximum users - users in subscription)
2020-11-24 15:15:51 +05:30
2021-11-18 22:05:49 +05:30
### Add users to your subscription
2021-01-03 14:25:43 +05:30
2022-03-02 08:16:31 +05:30
Your subscription cost is based on the maximum number of seats you use during the billing period.
Even if you reach the number of seats in your subscription, you can continue to add users.
GitLab [bills you for the overage](../quarterly_reconciliation.md).
2021-01-03 14:25:43 +05:30
To add users to a subscription:
1. Log in to the [Customers Portal](https://customers.gitlab.com/).
1. Navigate to the **Manage Purchases** page.
1. Select **Add more seats** on the relevant subscription card.
1. Enter the number of additional users.
1. Select **Proceed to checkout**.
1. Review the **Subscription Upgrade Detail**. The system lists the total price for all users on the
2021-02-22 17:27:13 +05:30
system and a credit for what you've already paid. You are only be charged for the net change.
2021-01-03 14:25:43 +05:30
1. Select **Confirm Upgrade**.
2021-02-22 17:27:13 +05:30
The following is emailed to you:
2021-01-03 14:25:43 +05:30
- A payment receipt. You can also access this information in the Customers Portal under
[**View invoices**](https://customers.gitlab.com/receipts).
2021-11-18 22:05:49 +05:30
### Remove users from your subscription
To remove a billable user from your subscription:
1. On the top bar, select **Menu > Groups** and find your group.
1. On the left sidebar, select **Settings > Billing**.
1. In the **Seats currently in use** section, select **See usage**.
1. In the row for the user you want to remove, on the right side, select the ellipsis and **Remove user**.
1. Re-type the username and select **Remove user**.
2022-08-27 11:52:29 +05:30
If you add a member to a group by using the [share a group with another group](../../user/group/manage.md#share-a-group-with-another-group) feature, you can't remove the member by using this method. Instead, you can either:
2021-11-18 22:05:49 +05:30
- Remove the member from the shared group. You must be a group owner to do this.
- From the group's membership page, remove access from the entire shared group.
2021-03-11 19:13:27 +05:30
## Upgrade your GitLab SaaS subscription tier
2020-11-24 15:15:51 +05:30
To upgrade your [GitLab tier](https://about.gitlab.com/pricing/):
1. Log in to the [Customers Portal](https://customers.gitlab.com/customers/sign_in).
2021-01-03 14:25:43 +05:30
1. Select **Upgrade** on the relevant subscription card on the
[Manage purchases](https://customers.gitlab.com/subscriptions) page.
2020-11-24 15:15:51 +05:30
1. Select the desired upgrade.
1. Confirm the active form of payment, or add a new form of payment.
1. Check the **I accept the Privacy Policy and Terms of Service** checkbox.
1. Select **Confirm purchase**.
When the purchase has been processed, you receive confirmation of your new subscription tier.
2021-11-18 22:05:49 +05:30
## Subscription expiry
2021-02-22 17:27:13 +05:30
2021-11-18 22:05:49 +05:30
When your subscription expires, you can continue to use paid features of GitLab for 14 days.
On the 15th day, paid features are no longer available. You can
continue to use free features.
2021-02-22 17:27:13 +05:30
2021-11-18 22:05:49 +05:30
To resume paid feature functionality, purchase a new subscription.
2021-04-29 21:17:54 +05:30
2021-11-18 22:05:49 +05:30
## Renew your GitLab SaaS subscription
2020-11-24 15:15:51 +05:30
2021-11-18 22:05:49 +05:30
To renew your subscription:
2020-11-24 15:15:51 +05:30
2021-11-18 22:05:49 +05:30
1. [Prepare for renewal by reviewing your account.](#prepare-for-renewal-by-reviewing-your-account)
1. [Renew your GitLab SaaS subscription.](#renew-or-change-a-gitlab-saas-subscription)
2020-11-24 15:15:51 +05:30
2021-11-18 22:05:49 +05:30
### Prepare for renewal by reviewing your account
2021-06-08 01:23:25 +05:30
2021-11-18 22:05:49 +05:30
Before you renew your subscription:
1. Log in to the [Customers Portal](https://customers.gitlab.com/customers/sign_in).
1. On the **Account details** page, verify or update the invoice contact details.
1. On the **Payment Methods** page, verify or update the credit card on file.
1. In GitLab, review your list of user accounts and [remove inactive or unwanted users](#remove-users-from-your-subscription).
### Renew or change a GitLab SaaS subscription
Starting 30 days before a subscription expires, GitLab notifies group owners
of the date of expiry with a banner in the GitLab user interface.
To renew your subscription:
1. Log in to the [Customers Portal](https://customers.gitlab.com/customers/sign_in) and beneath your existing subscription, select **Renew**.
2022-03-02 08:16:31 +05:30
The **Renew** button remains disabled (grayed-out) until 15 days before a subscription expires.
You can hover your mouse on the **Renew** button to see the date when it will become active.
2021-11-18 22:05:49 +05:30
1. Review your renewal details and complete the payment process.
1. Select **Confirm purchase**.
2022-07-23 23:45:48 +05:30
Your updated subscription is applied to your namespace on the renewal period start date. It may take up to one day for the renewal to be processed.
2021-11-18 22:05:49 +05:30
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 the [Support team](https://support.gitlab.com/hc/en-us/requests/new?ticket_form_id=360000071293) for assistance.
For details on upgrading your subscription tier, see
[Upgrade your GitLab SaaS subscription tier](#upgrade-your-gitlab-saas-subscription-tier).
2022-07-23 23:45:48 +05:30
### Automatic subscription renewal
2021-11-18 22:05:49 +05:30
When you enable automatic renewal, the subscription automatically renews on the
expiration date without a gap in available service. An invoice is
generated for the renewal and available for viewing or download on the
[View invoices](https://customers.gitlab.com/receipts) page.
2022-07-23 23:45:48 +05:30
#### Enable or disable automatic subscription renewal
2021-11-18 22:05:49 +05:30
To view or change automatic subscription renewal (at the same tier as the
previous period), log in to the [Customers Portal](https://customers.gitlab.com/customers/sign_in), and:
- If a **Resume subscription** button is displayed, your subscription was canceled
previously. Click it to resume automatic renewal.
- If a **Cancel subscription** button is displayed, your subscription is set to automatically
renew at the end of the subscription period. Click it to cancel automatic renewal.
If you have difficulty during the renewal process, contact the
[Support team](https://support.gitlab.com/hc/en-us/requests/new?ticket_form_id=360000071293) for assistance.
2022-03-02 08:16:31 +05:30
## Add or change the contacts for your subscription
2020-11-24 15:15:51 +05:30
2022-03-02 08:16:31 +05:30
Contacts can renew a subscription, cancel a subscription, or transfer the subscription to a different namespace.
2020-11-24 15:15:51 +05:30
2022-03-02 08:16:31 +05:30
To change the contacts:
2020-11-24 15:15:51 +05:30
2022-03-02 08:16:31 +05:30
1. Ensure an account exists in the
[Customers Portal](https://customers.gitlab.com/customers/sign_in) for the user you want to add.
1. Verify you have access to at least one of
[these requirements](https://about.gitlab.com/handbook/support/license-and-renewals/workflows/customersdot/associating_purchases.html).
1. [Create a ticket with the Support team](https://support.gitlab.com/hc/en-us/requests/new?ticket_form_id=360000071293). Include any relevant material in your request.
2022-01-26 12:08:38 +05:30
2022-03-02 08:16:31 +05:30
## CI/CD minutes
2022-01-26 12:08:38 +05:30
2022-03-02 08:16:31 +05:30
CI/CD minutes are the execution time for your [pipelines](../../ci/pipelines/index.md)
on GitLab shared runners.
2022-01-26 12:08:38 +05:30
2022-03-02 08:16:31 +05:30
Refer to [CI/CD minutes](../../ci/pipelines/cicd_minutes.md)
for more information.
2020-11-24 15:15:51 +05:30
2022-03-02 08:16:31 +05:30
### Purchase additional CI/CD minutes
2020-11-24 15:15:51 +05:30
2022-03-02 08:16:31 +05:30
You can [purchase additional minutes](../../ci/pipelines/cicd_minutes.md#purchase-additional-cicd-minutes)
2022-04-04 11:22:00 +05:30
for your personal or group namespace. CI/CD minutes are a **one-time purchase**, so they do not renew.
2020-11-24 15:15:51 +05:30
2022-04-04 11:22:00 +05:30
## Add-on subscription for additional Storage and Transfer
NOTE:
2022-08-27 11:52:29 +05:30
Free namespaces are subject to a 5GB storage and 10GB transfer [soft limit](https://about.gitlab.com/pricing/). Once all storage is available to view in the usage quota workflow, GitLab will automatically enforce the namespace storage limit and the project limit will be removed. This change will be announced separately. The storage and transfer add-on can be purchased to increase the limits.
2021-02-22 17:27:13 +05:30
2022-08-27 11:52:29 +05:30
Projects have a free storage quota of 10 GB. To exceed this quota you must first
[purchase one or more storage subscription units](#purchase-more-storage-and-transfer). Each unit provides 10 GB of additional
2021-02-22 17:27:13 +05:30
storage per namespace. A storage subscription is renewed annually. For more details, see
[Usage Quotas](../../user/usage_quotas.md).
When the amount of purchased storage reaches zero, all projects over the free storage quota are
locked. Projects can only be unlocked by purchasing more storage subscription units.
2022-04-04 11:22:00 +05:30
### Purchase more storage and transfer
You can purchase a storage subscription for your personal or group namespace.
2021-02-22 17:27:13 +05:30
2022-04-04 11:22:00 +05:30
NOTE:
2022-07-23 23:45:48 +05:30
Storage subscriptions **[renew automatically](#automatic-subscription-renewal) each year**.
You can [cancel the subscription](#enable-or-disable-automatic-subscription-renewal) to disable the automatic renewal.
2022-01-26 12:08:38 +05:30
#### For your personal namespace
2021-02-22 17:27:13 +05:30
2021-03-11 19:13:27 +05:30
1. Sign in to GitLab SaaS.
2021-02-22 17:27:13 +05:30
1. From either your personal homepage or the group's page, go to **Settings > Usage Quotas**.
1. For each locked project, total by how much its **Usage** exceeds the free quota and purchased
storage. You must purchase the storage increment that exceeds this total.
2022-07-23 23:45:48 +05:30
1. Select **Purchase more storage** and you are taken to the Customers Portal.
1. Select **Add new subscription**.
2021-02-22 17:27:13 +05:30
1. Scroll to **Purchase add-on subscriptions** and select **Buy storage subscription**.
1. In the **Subscription details** section select the name of the user or group from the dropdown.
1. Enter the desired quantity of storage packs.
1. In the **Billing information** section select the payment method from the dropdown.
1. Select the **Privacy Policy** and **Terms of Service** checkbox.
1. Select **Buy subscription**.
1. Sign out of the Customers Portal.
2021-03-11 19:13:27 +05:30
1. Switch back to the GitLab SaaS tab and refresh the page.
2021-02-22 17:27:13 +05:30
The **Purchased storage available** total is incremented by the amount purchased. All locked
projects are unlocked and their excess usage is deducted from the additional storage.
2022-01-26 12:08:38 +05:30
#### For your group namespace
> [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/5789) in GitLab 14.6.
If you're using GitLab SaaS, you can purchase additional storage so your
pipelines aren't blocked after you have used all your storage from your
main quota. You can find pricing for additional storage on the
[GitLab Pricing page](https://about.gitlab.com/pricing/).
To purchase additional storage for your group on GitLab SaaS:
1. On the top bar, select **Menu > Groups** and find your group.
1. On the left sidebar, select **Settings > Usage Quotas**.
1. Select **Storage** tab.
1. Select **Purchase more storage**.
1. Complete the details.
After your payment is processed, the extra storage is available for your group
namespace.
To confirm the available storage, go to your group, and then select
**Settings > Usage Quotas** and select the **Storage** tab.
The **Purchased storage available** total is incremented by the amount purchased. All locked
projects are unlocked and their excess usage is deducted from the additional storage.
2020-11-24 15:15:51 +05:30
## Contact Support
Learn more about:
- The tiers of [GitLab Support](https://about.gitlab.com/support/).
- [Submit a request via the Support Portal](https://support.gitlab.com/hc/en-us/requests/new).
2021-11-18 22:05:49 +05:30
We also encourage you to search our project trackers for known issues and
2020-11-24 15:15:51 +05:30
existing feature requests in the [GitLab](https://gitlab.com/gitlab-org/gitlab/-/issues/) project.
These issues are the best avenue for getting updates on specific product plans
and for communicating directly with the relevant GitLab team members.
## Troubleshooting
### Credit card declined
If your credit card is declined when purchasing a GitLab subscription, possible reasons include:
- The credit card details provided are incorrect.
- The credit card account has insufficient funds.
- You are using a virtual credit card and it has insufficient funds, or has expired.
- The transaction exceeds the credit limit.
- The transaction exceeds the credit card's maximum transaction amount.
Check with your financial institution to confirm if any of these reasons apply. If they don't
apply, contact [GitLab Support](https://support.gitlab.com/hc/en-us/requests/new?ticket_form_id=360000071293).