# Connect self-hosted GitLab

### Connect Self-Hosted GitLab in Violet

1. In [Violet](https://app.violetlabs.com/) (or [VioletGov](https://app.violetgov.com/)), navigate to **Integrations** and click  <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FtlFf29W81Xw97AUJ5zwb%2FScreenshot%202026-02-19%20at%201.13.34%E2%80%AFPM.png?alt=media&#x26;token=c80f613a-d379-4cd4-a5c8-9c04e63e37ea" alt="" data-size="line"> to add a new integration.&#x20;
2. Select <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FcxfqrzhteuJZuB0cqVxw%2Fgitlab.png?alt=media&#x26;token=9e82b8c3-ed93-4706-91b1-974b7e3a3ca3" alt="" data-size="line"> **GitLab.**
3. Toggle **Cloud Installation** off and provide the URL for your GitLab instance, followed by `/api`

![](https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FP0Fzrih627UM4KxLAzye%2FGitLabSelfHosted.png?alt=media\&token=ebb65b5e-de77-4dc0-817b-e923cc2e9f38)

4. Enter your API token (follow the instructions [here](https://docs.violetlabs.com/apps/g/gitlab/generate-a-gitlab-api-token) to generate one) and click **Connect.**

\[Optional] You can also provide a unique name for the connection based on the credentials you're using, and you can create **restricted permissions** to users or groups:

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FLNq8XfPFudyBudwAhJwe%2Fpermissions.png?alt=media&#x26;token=502752e3-2f38-4c8b-8fa0-2ff8b3a5a19a" alt="" width="375"><figcaption></figcaption></figure>

4. Once connected, you can configure which types of data to ingest, how frequently data should be refreshed, etc.&#x20;
5. Last, click **Create** to begin fetching data. You're done!

Note, depending on your network settings, Violet may also need to be allowlisted by your GitLab server in order to connect. \
\
If so, allowlist the appropriate NAT Gateway IP address below:

* for Violet (violetlabs.com) : [50.19.87.143](https://us-east-1.console.aws.amazon.com/vpcconsole/home?region=us-east-1#Addresses:public-ip=50.19.87.143)
* for VioletGov (violetgov.com): [3.31.169.141](https://console.amazonaws-us-gov.com/vpc/home?region=us-gov-west-1#Addresses:public-ip=3.31.169.141)
