GitLab Server (On-Prem) Connection Guide

Follow the steps below to establish the connection.

1. Select GitLab Server as Your Git provider

1. Navigate to Settings > Company Settings, and select the Git tab.
2. Click Add Integration and choose GitLab Server as your Git provider.

2. Allowing LinearB Access

If your GitLab Server instance is accessible from the public internet, skip this step.

If your GitLab Server is hosted within a private network, you must allow LinearB's public IP addresses in your firewall:

• 52.15.80.85
• 18.118.232.229

For networks behind a VPN, ensure that a reverse proxy allows LinearB-specific access to GitLab Server

3. Insert Your GitLab Server URL

1. After allowing LinearB’s IPs, enter your GitLab Server URL.
2. LinearB will automatically check connectivity.
3. Once verified, click Continue and proceed to the next step.

4. Create a Personal Access Token

1. Log in to GitLab Server and click your avatar in the upper-right corner.
2. Select Settings from the dropdown menu.

1. In the User Settings menu, navigate to Access Tokens.

1. Enter a name for the token and optionally set an expiry date.
2. Enable the following access scopes:
   • read_user
   • api
   • read_repository
   • write_repository

     

3. Click Create Personal Access Token.

   

4. Copy the token immediately, as it will not be visible again after this step.

Make sure to select a GitLab user which has "Maintainer" or "Owner" access to your org, or is a "Member" of all relevant repositories.

Store the token securely for future use.

5. Validate and Connect

1. Paste the personal access token into the LinearB setup interface.
2. LinearB will automatically validate the token.
3. Once validated, proceed to repository selection.

Related Guides

• BitBucket Server (On-Prem) Connection Guide
• GitHub Server (On-Prem) Connection Guide
• Jira Server (On-Prem) Connection Guide

For further assistance, visit our Support Page.