gitlab-org--gitlab-foss/doc/subscriptions/index.md
Evan Read d05eebe1dd Fix most bare URLs in project
Linting rule not enabled for now
because tooling produces false
positives.
2019-07-02 08:50:00 +00:00

7.8 KiB
Raw Blame History

type
index, reference

Subscription setup and management

This page will help get you started with your new subscription or manage an existing one, whether you have subscribed to GitLab.com or self-managed GitLab.

To subscribe, upgrade, or read more about the types of subscriptions, please see Subscribe to GitLab on the GitLab Documentation landing page.

Set up GitLab

Learn how GitLab helps you in the stages of the DevOps lifecycle by learning more about the GitLab product, GitLab features, and GitLab Documentation.

Self-managed: Install GitLab

Take a look at installing GitLab and our administrator documentation. Then, follow the instructions below under Your subscription to apply your license file.

GitLab.com: Create a user and group

Start with creating a user account for yourself using our sign up page.

GitLab groups help assemble related projects together allowing you to grant members access to several projects at once. A group is not required if you plan on having projects inside a personal namespace.

Your subscription

You can view and manage subscriptions through our Customers portal. Information on applying your subscription is below.

Please also see our subscription FAQ

View subscription and seats

To view and manage the subscriptions you have purchased and the number of seats associated with the subscription, please visit and log into the Customers Portal. For more information, please see our subscription FAQ and pricing page, which includes information on our true-up pricing policy when adding more users than at the time of purchase.

Please note that this account may have the same email, but is a separate login from your GitLab.com account. If the two accounts are linked together, then you can use the "sign in with GitLab.com account" link underneath the Sign In button.

Change billing information

In the customers portal, go to the My Account page, then revise the Account Details information and click on the Update Account button.

Future purchases will use the information in this section. The email listed in this section is used for the Customers Portal login and for license related email communication.

Self-managed: Apply your license file

After purchase, the license file is sent to the email address tied to the Customers portal account, which needs to be uploaded to the GitLab instance.

NOTE: Note: This is required for GitLab.com subscriptions.

Once signed into the customers portal, if your account is not already linked, you should be prompted to link your account with a "Link my GitLab Account" button.

You can also go to the My Account page to add or change the GitLab.com account link.

Change the linked GitLab.com account for your Customers Portal account

To change which GitLab.com account is associated with a Customers Portal account, please follow these steps:

  1. Log into the Customers Portal.
  2. In a separate browser tab, visit GitLab.com to ensure you are not logged in, or if you are, log out.
  3. Back on the Customers Portal page, click My Account in the top menu.
  4. Under Your GitLab.com account, click the Change linked account button.
  5. Have the user you want associated log in to their GitLab.com account.

GitLab.com: Associate your namespace with your subscription

Once your GitLab.com account is linked, you can go to your Subscriptions page to choose or change the namespace your subscription applies to.

Please note that you need to be a group owner to associate a group to your subscription.

Confirm or upgrade your GitLab.com subscription details within GitLab

To see the status of your GitLab.com subscription, you can click on the Billings section of the relevant namespace:

  • For individuals, this is located at https://gitlab.com/profile/billings under in your Settings,
  • For groups, this is located under the group's Settings dropdown, under Billing.

For groups, you can see details of your subscription - including your current plan - in the included table:

Billing table

Field Description
Seats in subscription If this is a paid plan, this represents the number of seats you've paid to support in your group.
Seats currently in use The number of active seats currently in use.
Max seats used The highest number of seats you've used. If this exceeds the seats in subscription, you may owe an additional fee for the additional users.
Seats owed If your max seats used exceeds the seats in your subscription, you'll owe an additional fee for the users you've added.
Subscription start date The date your subscription started. If this is for a Free plan, this is the date you transitioned off your group's paid plan.
Subscription end date The date your current subscription will end. This does not apply to Free plans.

Subscription changes and your data

When your subscription or trial expires, GitLab does not delete your data, however, depending on the tier and feature, it may become inaccessible. Please note that some features may not behave as expected if a graceful fallback is not currently implemented, such as environment specific variables not being passed.

If you renew or upgrade, your data will again be accessible.

For self-managed customers, there is a two-week grace period when your features will continue to work as-is, after which the entire instance will become read only. However, if you remove the license, you will immediately revert to Core features.

Need help?

GitLab's Documentation offers a wide range of topics covering the use and administration of GitLab.

We also encourage all users to search our project trackers for known issues and existing feature requests in:

These issues are the best avenue for getting updates on specific product plans and for communicating directly with the relevant GitLab team members.

Contacting Support

Learn more about the tiers of GitLab Support or submit a request via the Support Portal.