> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tierzero.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

> Code repository and DevOps platform

## Overview

Connect your GitLab instance to give TierZero access to your repositories, merge requests, pipelines, and deployments. TierZero uses GitLab to correlate code changes with incidents and analyze CI/CD pipeline results.

## Prerequisites

* Administrative access to your GitLab group or instance
* Permission to create access tokens

## Setup Instructions

### Step 1: Navigate to Integration Settings

1. Log into your TierZero dashboard
2. Go to **Settings → Integrations**
3. Click **Connect** next to GitLab

### Step 2: Create an Access Token

1. In GitLab, go to your group's **Settings → Access Tokens** (or use a personal access token)
2. Create a new token with the following scopes:
   * `read_api`: Read access to the API
   * `read_repository`: Read access to repository files
3. Set an expiration date and click **Create**
4. Copy the generated token

### Step 3: Enter Credentials

1. Paste the access token into TierZero
2. Enter your GitLab instance URL (for self-hosted instances)
3. Click **Connect**

## What TierZero Accesses

* **Repository contents**: Code files, branches, and directory structure
* **Commit history**: Recent commits, diffs, and authors
* **Merge requests**: Open MRs, discussions, and CI results
* **Pipelines**: CI/CD pipeline runs, jobs, and logs
* **Deployments**: Deployment history and environments

## Security

* TierZero uses scoped access tokens
* Read-only access to repositories and API
* Tokens are encrypted at rest
* Revoke access by deleting the token in GitLab

## Troubleshooting

### Repository Not Visible

* Verify the access token has the `read_api` and `read_repository` scopes
* For group tokens, check that the repository belongs to the token's group
* For self-hosted instances, ensure the GitLab URL is correct