GitLab

Let your team sign in with their GitLab accounts. Works with both GitLab.com and self-hosted GitLab.

Your redirect URI

GitLab will ask for a redirect URI. Use your hub’s URL with this exact path:

https://your-hub-url/api/auth/gitlab/callback

Setup

Open your applications

Click your avatar in the top-right, go to Edit profile, then Access → Applications in the sidebar. Click Add new application.

Set the redirect URI

Set the Redirect URI to https://your-hub-url/api/auth/gitlab/callback.

Enable the scopes

Tick the openid, email, and profile scopes. Perch asks for all three.

Add the credentials to Perch

Click Save application, copy the Application ID and Secret, then paste both into the GitLab card in Perch (Admin → Auth) and enable it.

Self-hosted GitLab

Running your own GitLab? Fill in the Base URL field with your instance URL, including the scheme (like https://gitlab.yourcompany.com). Leave it blank to use https://gitlab.com.

Tip

For a self-hosted instance, create the OAuth application in the admin area under Admin → Applications so it’s available to everyone, rather than tucked under a personal profile.

Domain restriction

Fill in Allowed Domain to limit sign-ins to a specific email domain.