Connecting Self-Managed GitLab

Our platform supports both GitLab Cloud (your user account is on gitlab.com) and GitLab Self-Managed (your organization administers and maintains its own GitLab instance). 

Before you begin:

  • Please verify that you are an owner of the GitLab group you wish to connect to Software.com. If you’re not an owner, invite one to help set up your account. 
  • If you have IP restrictions enforced, please contact us at support@software.com.

To connect a self-managed GitLab instance, select GitLab from our available integrations. You can add GitLab from your organization’s settings by navigating to the Settings view in the Software.com app and selecting the Connected Apps tab.

You will be asked to choose the type of GitLab instance your organization is running. Select Self-Managed

Follow the steps below to connect GitLab:

  1. Select a Group. You can only connect one group to Software.com. We recommend choosing an organization-wide group for better visibility across teams.
  2. Select Settings, then Applications in the left sidebar.


  3. Click Add New Application


  4. Enter the information below to create the new Group application:
    1. Name: Software.com
    2. Redirect URI: https://app.software.com/gitlab_onboarding/create
    3. Confidential: checked
    4. Scopes: api


Due to limitations in GitLab’s scopes, our platform requires api, not read_api, in order to install webhooks on each project. Please note that we never read, transmit, or store source code. We also do not edit or modify code or files.

  1. Click Save Application to generate application credentials. 
  2. Copy the Application ID and Secret. Store these credentials securely, as they can not be accessed again later. Only select Continue once you have these copied and stored securely.
  3. Navigate back to Software.com and paste the Application ID and Secret. Click Save.


  4. Activate your GitLab App. You will be redirected to authorize Software.com to access your account.

After connecting, you can manage your GitLab integration from the Applications page.

Still need help? Contact Us Contact Us