In this guide we're going to show you how to use Softagram with your repositories in self-hosted GitLab.

Please ensure that your GitLab server is available from the Internet. If it's not, you either need to add some firewall rules (let us know in the chat) or turn into using Softagram Enterprise.

1. Create a new project / Select project

Select switcher (top right corner part, similar as in the picture below) to open list of teams and projects

Select a project or create new project (find more: here)

If adding repositories to exist project, choose the setting icon on the project card and choose 'Add new repositories'

2. Add repositories from GitLab Self-Hosted

You will go directly to this prompt after select 'Add new repositories' or setup name for project

  • Note: If you did not setup your Gitlab Server base URI and Token, follow the below steps.
  • You can choose to do either one in two ways below

2.1 Setup in Workspace Settings - Integration:

Read more from here on how to open workspace settings

Open Gitlab Self-Hosted to change settings


Enter GitLab service base URI, e.g. https://gitlab.example.com and your Personal Access Token ("api" and "read_repository" permission)

  • Note: In this step we strongly advise to create a new GitLab account called "Softagram Bot". The account needs to have the "Maintainer" permission level in order to fetch code for analysis and post back the impact reports to merge requests. Softagram never pushes back any code changes to your repositories!

Then click Save. Go back to project settings and select 'Repositories' to modify.

2.2 Setup directly from the box when adding repositories

In project settings, select 'Repositories', then 'Add new Repositories'

Choose Gitlab as your service and 'Gitlab Self-Hosted' (Same as above)

A prompt will appear: 

Fill in the form then go forward.

3. Select the desired repositories from the list

4. Done! On the next merge request you'll get your first Softagram Impact Report.

  • Note: Do not forget to enable Analysis for us to analyse your merge request

In case your new & updated merge requests do not get comments from Softagram, please check that the webhook was created correctly. We try to create it automatically when you add the repo but sometimes it fails - for example if the authenticated GitLab user has no permission to create one. In that case you have to create it like this:

  1. Go to your GitLab Enterprise
  2. Click Settings in Sidebar
  3. Click Integrations
  4. Add a new webhook with URL https://private.softagram.com/api/gitlab-pullrequest-commenter-webhook
  5. Select "Trigger Merge Request Events". You can uncheck any other triggers.

Any issues with the setup or not getting any impact reports? Contact us in the chat or send email to support at softagram.com, we are glad to help!

Did this answer your question?