VCS Provider: Gitlab

Integrating your Gitlab application with DeepSource requires a Gitlab application. This document outlines the configuration, permission requirements and app configuration to get started with your GitLab account and DeepSource Enterprise.

Creating a GitLab application.

1. On the top right corner, click on your profile picture. From the drop-down menu, select "Preferences".

2. Select "Applications" from the sidebar which appears on the left.

3. You'd be prompted to fill a form to create a new application. Enter the following details:

   Note: Replace ORGANIZATION_NAME with the name of your organization, and HOSTNAME with the actual hostname on which you plan to deploy DeepSource to.

   Field	Value	Example
   Name	DeepSource ORGANIZATION_NAME	DeepSource Stark International
   Redirect URI	https://HOSTNAME/accounts/gitlab/login/callback/bifrost/	https://deepsource.stark.com/accounts/gitlab/login/callback/bifrost/
   Confidential	true
   Scope	Check true for api, read_user and read_repository

4. Click "Save Application".

5. It shall provide you with APPLICATION_ID and SECRET. Enter these values in the DeepSource Enterprise admin console.

Configuring the GitLab application in the Admin Console

After you create your GitLab application, you need to configure these in the Admin Console for the application to use it.

1. Visit the Admin Console
2. Navigate to Application -> Config.
3. Select the checkbox for GitLab
4. Fill up the values from the previous step for:
   1. GitLab Application ID
   2. GitLab Application Name
   3. GitLab Application Secret
   4. GitLab Host Domain
   5. GitLab Webhook Secret
5. Save

Note: You can ignore the Custom Redirect URI Hostname field if you are using the same domain for all traffic.