To use your GitLab repositories with Release, choose the "Sign in with GitLab" option. You'll be prompted to authorize Release for read/write access to the API.
GitLab authorization
Note that can you authenticate with multiple different source providers (e.g. GitHub and GitLab). If you use the same email address for those providers, you will be able to see a combined view of repositories for all providers, and each integration will appear separately on your user profile page.
multiple integrations

Self-hosted GitLab

It is possible to connect Release with your self-hosted Gitlab with a few extra steps. It requires some configurations on Gitlab's side as well as some custom configuration on Release.
To get started, you'll need to create an application on your GitLab server. Assuming your installation is pointed at, you will need to create an application by going to The Application form should look something like this:
GitLab Application
You can name the Application however you'd like, but for clarity, you can name it Release. Then, you'll need to whitelist a callback URL that will be used by GitLab to finish the OAuth handshake. You'll also need to set the scopes so that Release has the right permissions level to interact with your repositories.
  • Redirect URI:
  • Scopes: api
Once you save the application, you'll be presented with information about your application. There will be an application ID and a secret ID. You will need those in the next step.

Back to Release

Let's go back to Release and open up the User's Profile. You will be presented with all the version control that are currently supported by Release. For Gitlab integration, you'll need to configure the section called GitLab - Self Hosted. Once you click on Configure, you'll be able to enter the application id, secret id and the URL for your GitLab server. Given the example URL above, it would look like this:
  • URL:
  • Application ID: ID from the save screen on GitLab
  • Client Secret: Secret from the save screen on GitLab
Once you save the dialog, a new button will appear that will let you connect to your application. Clicking on it will redirect you to your Gitlab Enterprise authorization page. When you run this for the first time, you may see a warning page on GitLab to ask you to confirm that you want to use the application you created above.
GitLab Authorization
Authorize the application, you'll be redirected back to Release and you'll be ready to start using Release.