Gitlab Server

How do I sign-up with GitLab Server?

Data Access by Hivel

• Hivel accesses the past 60-90 days of commits and pull requests from active repositories during the initial sync.

Authorization Mechanism

• Hivel employs GitLab Server's OAuth for authentication.

• Users maintain full control and can withdraw access by revoking the Personal Access Token.

Effortlessly Connect Your GitLab Server with Hivel

This easy-to-follow guide will lead you through each step, ensuring a smooth and efficient integration process to unlock efficiency insights across your org.

Step 1: Gather Your GitLab Server Details

First things first, let's get some essential information from your GitLab Server:

• GitLab Server URL: This is your gateway to accessing your GitLab Server. Look for an address in the format of https://{your-git-domain}.com/. Don't forget to replace {your-git-domain} with your actual domain.

• GitLab Server Version: Compatibility is key, and knowing your GitLab Server version is crucial. Here's how to find it:

  • Head over to your GitLab Server interface.

  • Click on the 'Help' section. It’s usually at the end of your GitLab URL, like this: /help.

  • You'll see your version info displayed, typically in the format of "GitLab Community Edition {x.x.x} / GitLab Enterprise Edition {x.x.x}".

Step 2: Whitelist Necessary IP Addresses

For a secure and uninterrupted connection, make sure to whitelist the following IP addresses:

• Recommended, but Optional IPs:

  • 45.119.114.218

  • 183.82.116.218

• Mandatory IPs:

  • 107.23.139.76

  • 3.219.89.23

Step 3: Creating a Personal Access Token (PAT):

Let's create your PAT in GitLab:

1. Click on your avatar in the top-right corner of your GitLab account.

2. Select 'Preferences'.

3. Navigate to 'Access Tokens' in the left sidebar.

4. Enter a token name and opt not to set an expiry date.

5. Select the following scopes: api, read_api, read_user, read_repository.

6. Click 'Create personal access token'. Note these scopes as they're crucial for integration.

Step 4: Navigate to the Hivel sign-up page

Step 5: Add your work email id (If you'd like to use your personal email id please contact [e-mail])

Step 6: Now, you can use your Google or Microsoft login with your work email id; or create a password.

Step 7: Create your Company Profile, and click 'Get Started'.

Step 8: Once you've successfully created your Company Profile you will be redirected to the Integrations Page.

Step 9: Select Bitbucket, and log in to your company's Bitbucket account using a service account.

Step 10: Share Your Details

You’ll need to provide the following:

• Email, preferably a service account such as [[e-mail]]

• Username

• Personal Access Token (PAT) - return to the Hivel application, paste the personal access token, and hit Submit.

Below are some screenshots of the steps you can refer to if needed: