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'

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

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)

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.

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:

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!