GitLab Self Hosted Setup

Updated 8 months ago by Jaala


Below is a step-by-step guide on how to connect your Self Hosted GitLab account to GitPrime. If your repositories are behind a firewall, please whitelist our IPs first. Here is a link to get you started. This configuration requires a connection via HTTPS over port 443.

We strongly recommend you use a service account to create this Integration. Please see this help document for instructions to create a service account and read more about why service accounts are important here. The service account will need to be added to the GitLab groups with at least a "reporter" permission in order to import repos into GitPrime.

GitLab Enterprise Configuration: 

Step 1: In order to connect your GitLab Enterprise, you will need to first create a new Integration. Starting on your GitPrime Home page go to the left navigation bar. At the bottom go to Settings > Integrations.

Step 2: Select the Add Integration button in the top right hand corner of you Integrations screen. 

Step 3: On the following page select GitLab Self-Hosted and click Next.

Step 4: In this next step you can choose to connect via an OAuth Application or Access token. Choose the connection that works best for you. 

A.) OAuth

Step 1: On any page of your GitLab instance, click your user icon and then navigate to Settings and Applications.

Step 2: Fill in the following information under Add new application:

Step 3: Fill in your Application ID, Client Secret and Base URL into the GitPrime integration screen. 

Before proceeding to the next step, make sure you have pop-ups disabled on your browser. The following steps will include a pop-up that will finalize your connection to your GitLab account. If you have pop-ups blocked, you will have to start all over.

Step 4: Click Connect to GitLab Self-Hosted. If GitPrime is able to successfully access your instance you will see the message below.

If your connection is not successful, please double check your Client ID and Secret, Base URL and the callback URL you provided when creating the OAuth application in GitLab.

B.) Access Token

You can connect via an access token. On the tab input your access token and click Test connection. For more information on where to create an access token in GitLab see GitLab’s support document Personal Access Tokens.

If the connection was successful you will see the following message: 

If you receive an error when trying to connect your GitLab account using an access token verify the access token and base URL and try again. 

Step 5: Once you have successfully connected to your GitLab account, click Next.

Step 6: After clicking Next on your screen, you will be selecting the services you want turned on for this Integration. If you would like to import Ticket and Pull Request data in addition to Repo data, then leave all services on. You can turn services “on” and “off” at any time. Click Next.

Step 7: Name your integration so it’s clear what account it is connected to. 

Step 8: You have successfully created a new GitHub Enterprise Integration. 

Step 9: You can begin to import your repos by clicking repo import page. To learn more about managing your new Integration settings, see Managing Integrations.

Still having problems setting up your GitHub Enterprise account? Email us at or click on the chat icon in the bottom right corner of your screen.

How did we do?