Configure GitLab OAuth
Create a GitLab OAuth application so Coolify can read the authenticated user's profile and email address. The same Coolify provider card supports GitLab.com and self-managed GitLab.
Replace these values while following the guide:
- Coolify callback:
https://coolify.shadowarcanist.com/auth/gitlab/callback - GitLab.com Base URL: leave empty
- Self-managed Base URL:
https://gitlab.shadowarcanist.com
Set up GitLab OAuth
Open GitLab applications
Sign in to GitLab, open your avatar menu, select Edit profile, then open Access > Applications.
On a self-managed instance, an administrator can create an instance-wide application instead when organizational ownership is required. Follow GitLab's OAuth provider documentation for the applicable application location.
Create the OAuth application
Select Add new application and enter:
| GitLab field | Value |
|---|---|
| Name | A recognizable name such as Coolify. |
| Redirect URI | https://coolify.shadowarcanist.com/auth/gitlab/callback |
| Confidential | Enabled. Coolify stores and uses a client secret. |
| Scopes | Select read_user. |
Save the application.
Save the GitLab credentials
Copy the Application ID and Secret from the created application.
Store the secret securely. If GitLab no longer shows the complete value, create or rotate the secret before continuing.
Configure GitLab in Coolify
Open Settings > OAuth and find GitLab.
| Coolify field | GitLab value |
|---|---|
| Client ID | The GitLab Application ID. |
| Client Secret | The GitLab application Secret. |
| Redirect URI | https://coolify.shadowarcanist.com/auth/gitlab/callback |
| Base URL | Leave empty for GitLab.com. For self-managed GitLab, enter only its origin, such as https://gitlab.shadowarcanist.com. |
Select Save, then turn on Enabled for GitLab.
Verify GitLab sign-in
Open the Coolify login page in a private browser window and select Login with GitLab. Approve the application if requested, then confirm that Coolify opens the account matching the GitLab email address.