Skip to main content

Self-Hosted GitLab Integration

Step 1 - Register a New OAuth Application in Your GitLab Instance​

Required: You must have administrator access to your GitLab server.

  • Log in to your GitLab instance (e.g., https://gitlab.yourcompany.com) as an admin.
  • Go to your user profile and select Edit Profile.
  • From the left sidebar, choose Applications.
  • Under New Application, fill in the form:

    • Name:
      GitMe Performance Tracking

    • Redirect URI:

      https://backend.gitdotme.com/gitlab/callback
  • Scopes:
    • read_repository
    • read_user
    • read_api
    • openid
    • email
  • Confidential: Should be checked.
  • Click Create application.
  • Copy your Application ID and Secret — you will need these in the next step.

Step 2 - Connect Your GitLab Instance to GitMe​

  • Visit the GitMe application and navigate to the Self-Hosted GitLab Integration section.
  • Provide the GitLab instance URL (e.g., https://gitlab.yourcompany.com), and the Application ID and Secret you obtained above.
  • Click Connect with Self-Hosted GitLab Button.

Connect-with-Self-Hosted-GitLab

Step 3 - Authorize GitMe via Your Instance​

  • After clicking Connect with Self-Hosted GitLab Button you will be redirected to your company’s GitLab authorization page.
  • Review the requested permissions and click Authorize.

GitLab-Request-Access

Step 4 - Complete the Profile and Repository Selection​

  • After successful authorization, you’ll be redirected back to GitMe’s onboarding page.
  • Fill in the required fields:
    • Company Name: (Required)
    • Full Name: (Required)
    • Email: (Required)
  • Repository Selection:
    • A list of repositories you have access to will appear (see below)
    • Select which repositories you want GitMe to analyze (checked by default, uncheck to exclude any repo)
    • This gives you fine-grained control—you choose which codebases are analyzed.

GitLab-Select-Repositories

Step 5 - Accept the Agreement​

  • Read the agreement terms.
  • Check the box "I have read and accept the agreement."
  • Click Get Started.
  • Provide your company name, full name, and company email address to begin.

Accept-the-Agreement

Step 6 - Choose your plan​

  • Choose the plan that works best for your organization to unlock GitMe’s full features.
warning

⚠️ Network Access Requirements

To successfully integrate with GitMe, the following network requirements must be met:

  • Your Self-Hosted GitLab server must allow outbound internet connections to GitMe’s cloud endpoint:
    • https://backend.gitdotme.com
  • GitMe’s cloud servers must be able to access your Self-Hosted GitLab instance over the internet (e.g., https://gitlab.yourcompany.com) to fetch repository and commit data via the API.
  • Webhooks: Your Self-Hosted GitLab instance must be able to deliver webhook events to GitMe’s webhook URL.

If your Self-Hosted GitLab server is not accessible from the internet, or outbound access to GitMe’s endpoints is blocked, the integration will not be possible.