Connecting to your source control repository with Gearset allows you to deploy to and from your source of truth. This article shows you how simple it is to connect to your cloud-based repo on https://gitlab.com/.

If your GitLab repository is not on the URL https://gitlab.com/, it's likely you have an on-premise instance, called Self-Managed GitLab. We have a separate document to guide you through that process.

Once you're logged into Gearset, head to the Source control and services section and click on the Connect to GitLab link.

This will take you to GitLab's OAuth page for authentication.

Double-check that your organization has given us access to your repo. If not, you may need to request it from your repo owners. Once you are happy to proceed, click on the Authorize Gearset button to continue and input your password.

Once complete, it should look like this (with your authenticated GitLab username being visible):

Additionally, your GitLab applications settings should show you an authorised app, called Gearset. You have the ability to revoke the application at any time.