For GitLab integrations, there are 2 high level steps

  1. Generate Personal Access Token

  2. Provide Access Token to Haystack from integrations page

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

Afterward, you’ll be able to see your organization's data on https://dash.usehaystack.io, 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, paste the access token and your organization url.

Click Test & Save, if everything works fine you will redirected to 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 contact you once your data is fetched.

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

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

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

Did this answer your question?