All Collections
Advanced Setup
Setup GitLab and GitLab Enterprise
Setup GitLab and GitLab Enterprise

Setup Gitlab or self-hosted GitLab Enterprise.

Julian Colina avatar
Written by Julian Colina
Updated over a week ago


For GitLab integrations, there are 2 high level steps

  1. Generate Personal Access Token

  2. Provide Access Token to Haystack from the integrations page

  3. (Only self-hosted) Open GitLab firewall to Haystack IPs

Afterward, you’ll be able to see your organization's data on, get all updates at the same speed as Cloud users.

You can find detailed instructions on each step below.

Generate Personal Access Token

You can create as many personal access tokens as you like from your GitLab profile.

  1. Log in to GitLab.

  2. In the upper-right corner, click your avatar and select Settings.

  3. On the User Settings menu, select Access Tokens.

  4. Choose a name and optional expiry date for the token - Don't set any date.

  5. Choose the desired scopes - For Haystack we need only api scope and read_user scope..

  6. Click the Create personal access token button.

  7. Save the personal access token somewhere safe. Once you leave or refresh the page, you won’t be able to access it again.

Here is the example:

Copy/Paste your Access token

Go to Haystack, and paste the access token and your GitLab base url.

Click Test & Save, if everything works fine you will be redirected to the integrations page and you will be able to see your integration details

You have installed Haystack on your GitLab organization successfully! Fetching the data might take up to 24 hours. Our team will reach out to you once your data is fetched.

  • GitLab base URL is for the self-hosted instances!

(Only self-hosted) Open GitLab firewall to Haystack IPs

Haystack API uses the following IP addresses to connect to GitLab.

For Haystack to access your servers, we'll need open firewall access to the given IPs.

Did this answer your question?