---
title: GitLab
description: Monitor GitLab seat usage, license assignments, and user activity through OpenLM Cloud Broker.
product: OpenLM Platform
---

OpenLM monitors GitLab seat usage and license assignments through OpenLM Cloud Broker.

## Before you begin

- An active OpenLM Platform tenant.
- OpenLM Cloud Broker, approved in [Broker Hub](https://openlm.com/documentation/cloud/data-collection/broker-hub).
- A GitLab Owner, Maintainer, or instance Administrator account that can issue a personal access token.

## Generate the GitLab personal access token

1. Sign in to GitLab as a user with permission to issue tokens (Owner, Maintainer, or instance Administrator).
2. Go to your avatar in the top-right corner and select **Edit profile**.
3. In the left sidebar, select **Access tokens**.
4. Select **Add new token**.
5. Enter a token name and (optional) expiration date.
6. Grant the token at least the `read_api` and `read_user` scopes so OpenLM Cloud Broker can read seat and user data.
7. Select **Create personal access token**.
8. Copy the token and store it securely — GitLab shows the token value only once.

:::tip
For self-managed GitLab, the token UI lives at `https://<your-gitlab-host>/-/user_settings/personal_access_tokens`. For GitLab.com, use `https://gitlab.com/-/user_settings/personal_access_tokens`.
:::

## Add the credential in OpenLM Cloud Broker

1. Open the OpenLM Cloud Broker dashboard.
2. Locate the **GitLab** integration.
3. Enter the following values:
    - GitLab host URL (for example, `https://gitlab.com` or your self-managed URL)
    - Personal access token

    *GitLab credential configuration in Cloud Broker*

4. Select **Test connection** and confirm the test passes.
5. Select **Save**.

## Approve GitLab in OpenLM Platform

1. Sign in to OpenLM Platform.
2. From the menu, go to **License Servers** → **Pending Server**.
3. Select the GitLab data source, then select **Approve and Merge**.

## Verify the integration

1. In OpenLM Platform, go to **Allocation**.
2. Confirm GitLab usage data appears.

:::note
It can take up to 3 minutes for data to appear after approval.
:::

## Approve GitLab in OpenLM Platform

1. Sign in to OpenLM Platform.
2. From the menu, go to **License Servers** → **Pending Server**.
3. Select the GitLab data source, then select **Approve and Merge**.

## Verify the integration

1. In OpenLM Platform, go to **Allocation**.
2. Confirm GitLab usage data appears.

:::note
It can take up to 3 minutes for data to appear after approval.
:::

## Viewing reports

- **User activity trends** — see which users are most active in the platform; reallocate seats accordingly.
- **Expired or unused licenses** — identify inactive users and reclaim their seats.

## Reference

- [Broker Hub](https://openlm.com/documentation/cloud/data-collection/broker-hub)