Provision GitLab licences

Subscription Admins (SAs) and Technical Admins (TAs) can provision GitLab licences to users using Console. You can provision a licence to a single user or multiple users.

Prerequisites

Ensure the following:

• You are a Subscription Admin (SA) or Technical Admin (TA).
• GitLab Ultimate is included in your SHIP-HATS subscription.
  See Subscribe to GitLab.
• Sufficient GitLab licences are available for provisioning.
• The user has an active TechPass account.
• You are using a non-SE GSIB, COMET, or GMD (SEED) device.

Things to note before you begin

• A user can hold only one GitLab licence in SHIP-HATS.
• If a user already holds a GitLab licence under another SHIP-HATS subscription, Console prevents duplicate provisioning.
  • In this case, a Subscription Admin (SA) or Project Admin (PA) can add the user directly to the required GitLab groups or projects.
• Users without an active TechPass account will not appear in search results for licence provisioning.

Steps

1. Log in to Console.

2. Go to Subscription Accounts and select the required SHIP-HATS subscription.

   

3. Go to User Management > GitLab.

4. Click the down arrow next to GitLab.

   

5. Check the licence Usage count.
   For example, 0/11 means 0 licences are in use and 11 are available.

6. If sufficient licences are available, click Manage.

   

   ⚠️ If licence quota is reached

   If there are no available licences:

   1. Increase the licence quantity in your subscription. See Update licences or units. In this page, select the Update licences or units tab.
   2. Then return to this page to provision licences to users.

7. Choose how you want to provision licences:

   Provision licence to a single user

   1. Click Add users.

      

   2. Use the Search box to find the user by name or email linked to their TechPass account.

      

      Users without an active TechPass account will not appear in the search results.

   3. Click Submit.

   4. Confirm the provisioning when prompted.

      Users who already hold this licence cannot be assigned another licence.

   Provision licence to multiple users (batch upload)

   1. Click Batch add.

   2. Download the template.

      

   3. Enter the TechPass email address of the users.

   4. Ensure:

      • The total number of users does not exceed the available licence count.
      • A maximum of 50 users can be added in one batch.

   5. Upload the completed template.

      

      To remove a user from the list, click the delete icon next to their User type.

   6. Click Submit.

   7. Confirm the provisioning when prompted.

   A GitLab licence allows users to log in. To access repositories, users must also be added to groups or projects and assigned a role.

   💡 Tip: Regularly review licence usage to avoid running out of available licences.

Related topics

• GitLab roles and permissions
• Create GitLab groups
• Invite users to GitLab