> For the complete documentation index, see [llms.txt](https://docs.iftrue.co/getting-started/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iftrue.co/getting-started/integrations/gitlab-self-managed/connect-gitlab-to-iftrue-using-a-personal-access-token.md).

# Connect GitLab to iftrue using a Personal Access Token

### Before You Start

Make sure the GitLab user you are using:

* Has access to the repositories you want to integrate
* Has sufficient permissions (at least read access to projects)

### Step 1 - Go to Personal Access Tokens

1. Navigate to 

   ```
   https://[your-gitlab-domain]/-/user_settings/personal_access_tokens
   ```
2. Enter a name (e.g., iftrue integration)
3. Set an expiration date (recommended: 1 year)
4. Select the following scopes:

   ✅ api

   ✅ read\_user

   ✅ read\_repository
5. Click Create personal access token

### Step 2 - Connect to iftrue

1. Open the GitLab integration page: 

   ```
   https://app.iftrue.co/onboarding/git?provider=gitlab&settings=true
   ```
2. Paste your token and base url for the gitlab into the required field
3. Complete the setup

<figure><img src="/files/KOWANKc5EUC9u2ISDbet" alt=""><figcaption></figcaption></figure>