Skip to main content
This page covers on-prem (self-hosted) setup. You register your own GitLab OAuth application so authentication runs against your GitLab instance. For the hosted SaaS integration, see Setup → GitLab.
You need permission to create an OAuth application in GitLab — under your User Settings → Applications, a Group, or the Admin Area depending on how you want to scope the app.

​
Register the GitLab OAuth app

1

Open Applications

In GitLab, go to Settings → Applications and click Add new application.
2

Fill in the details

FieldValue
NameGarth Assist
Redirect URIhttps://<dns-host>/api/garth-assist/oauth/gitlab/callback
ConfidentialEnabled
Replace <dns-host> with the DNS host of your on-prem Garth deployment — for example https://app.heygarth.ai/api/garth-assist/oauth/gitlab/callback.
3

Select scopes

Grant the following scopes:
ScopeDescription
apiAccess the API on your behalf
read_apiRead API
read_userRead your personal information
read_repositoryAllows read-only access to the repository
write_repositoryAllows read-write access to the repository
openidAuthenticate using OpenID Connect
profileRead-only access to the user’s personal information using OpenID Connect
emailRead-only access to the user’s primary email address using OpenID Connect
4

Save the application

Click Save application. GitLab shows the Application ID and Secret.
The secret is shown only once. Copy and store it securely before leaving the page.

​
Environment variables

Record the following values for your on-prem deployment:
Environment variableValue
GITLAB_CLIENT_IDThe Application ID shown after saving
GITLAB_CLIENT_SECRETThe Secret shown after saving