> For the complete documentation index, see [llms.txt](https://docs.kognitos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kognitos.com/guides/platform/integrations/gitlab.md).

# GitLab

Overview of the GitLab integration.

{% hint style="info" %}
The following documentation is for **GitLab v1.0.0**.
{% endhint %}

## Overview

GitLab is a DevSecOps platform that provides Git repository management, CI/CD pipelines, issue tracking, and code review. This integration allows you to manage your GitLab resources programmatically.

## Setup

The following integrations need to be connected to your Kognitos workspace:

* **GitLab**

### Steps

Follow these steps to connect the integration in Kognitos:

{% stepper %}
{% step %}

#### Navigate

Using the left navigation menu, go to **Integrations** → **Explore Integrations**.
{% endstep %}

{% step %}

#### Find

Search for the integration and click on it.
{% endstep %}

{% step %}

#### Connect

Click on <kbd>**Connect**</kbd> to add a connection to the integration.
{% endstep %}

{% step %}

#### Configure

Add a name for the connection. You'll be prompted for [**authentication**](#authentication) details if needed. Then, click on <kbd>**Connect**</kbd>.
{% endstep %}
{% endstepper %}

## Authentication

Use one of the following authentication methods to connect this integration in Kognitos. Each method has its own configuration requirements.

#### Connect using Personal Access Token

Connect to GitLab using a Personal Access Token.

| Label                 | Description                                                                                                                                                          | Type        |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| Personal Access Token | Your Personal Access Token from GitLab. Found in User Settings > Access Tokens.                                                                                      | `sensitive` |
| GitLab Instance URL   | The GitLab instance URL. Defaults to "<https://gitlab.com>" for GitLab.com. For self-managed instances, use your instance URL (e.g. "<https://gitlab.example.com>"). | `text`      |

## Actions

{% hint style="info" %}
The available actions for **GitLab** are listed in the product UI on the integration page once you create a connection.
{% endhint %}