# Gitlab (self-managed)

Estimated time to integrate: 4 minutes

***

## Getting Started

### Requirements

* You have an [iftrue](https://app.iftrue.co) account.
* You have your own Gitlab instance running on your own servers. eg: gitlab.example.com
* You have permission to create Gitlab Applications on your Gitlab Group.

### Variables Required

* Inbound IP addresses `34.36.101.243` `34.36.29.18`
* Outbound IP address `34.73.236.126`
* Callback url for oAuth APP `https://api.iftrue.co/v1/account/gitlab/callback`

### Adding Gitlab as a Git Provider

if you just signed up you will see this screen.

<figure><img src="/files/lEbk8mJgwEku84SqFhZa" alt=""><figcaption><p>Integrate GIT Provider Screen</p></figcaption></figure>

### Create Gitlab Application

We need to create Gitlab application to integrate iftrue. To access this page,

1. Click **Create Gitlab SSO Bridge**
2. **Navigate** to your Gitlab group settings. (Groups -> Select Group -> Settings)

<figure><img src="/files/5gQ1dTgZa4Q4RooIVksO" alt=""><figcaption><p>Gitlab Group Application Settings</p></figcaption></figure>

3. Set the callback URL and requested permissions.

**Copy paste the callback URL**

```
https://api.iftrue.co/v1/account/gitlab/callback
```

**We do not require repository read or write permissions.**&#x20;

<figure><img src="/files/l1qS4xWj3cs6GT2GAM8e" alt=""><figcaption><p>Gitlab Create Application</p></figcaption></figure>

4. **Copy and paste Application id and secret to iftrue**

<figure><img src="/files/YrsmOXZu5G01XvLFe04Z" alt=""><figcaption><p>Gitlab Application Secrets</p></figcaption></figure>

Copy those newly created application id and secret to iftrue onboarding page shown below.

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

5. **Enter your host url**

Insert your gitlab instances URL to the host URL section. This will validate your developers with oAuth.

6. **Create Integration once done**

Once you've created the application and the details, click create integration. This integration will be used by your own landing page in iftrue, which is,&#x20;

<mark style="color:blue;">**https\://\[your-organization-slug].app.iftrue.co**</mark>

When your team wants to signin you will use this address and your team will be able to signin with their Gitlab account by using oAuth 2.0.

7. **Create Access Token to Fetch Data**

We need to create access token to fetch data from your gitlab instance. In order to that,

navigate to groups settings and than click `Access Token`&#x20;

<figure><img src="/files/PO8Os2hVdqeG9oZGHeWj" alt=""><figcaption><p>Gitlab Group Access Token Menu</p></figcaption></figure>

Set the token properties as below,

<figure><img src="/files/pKAb6FzCOCVmTYcGc04Q" alt=""><figcaption><p>Gitlab Access Token Settings</p></figcaption></figure>

**Copy the access token and paste it to iftrue**

<figure><img src="/files/nHoprT7J7j38yGwnpvtF" alt=""><figcaption><p>Iftrue Gitlab Access Token Settings</p></figcaption></figure>

Hit save and you are ready to go :tada:


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iftrue.co/getting-started/integrations/gitlab-self-managed.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.