Configure GitHub OAuth
Create a GitHub OAuth App so GitHub can return a verified primary email address to Coolify after sign-in.
Replace the example domain while following this guide:
- Coolify URL:
https://coolify.shadowarcanist.com - Authorization callback URL:
https://coolify.shadowarcanist.com/auth/github/callback
Set up GitHub OAuth
Open GitHub OAuth Apps
Open GitHub Developer settings, select OAuth Apps, then select New OAuth App.
To let an organization own the credential, open that organization's settings and create the OAuth App there instead. You need permission to manage OAuth Apps for the selected account or organization.
Register the Coolify application
Complete the GitHub form:
| GitHub field | Value |
|---|---|
| Application name | A recognizable name such as Coolify. |
| Homepage URL | The public Coolify URL, such as https://coolify.shadowarcanist.com. |
| Application description | Optional information for people authorizing the app. |
| Authorization callback URL | https://coolify.shadowarcanist.com/auth/github/callback |
Select Register application.
A GitHub OAuth App has one callback URL. Create another OAuth App when a second Coolify instance uses a different public domain.
Create the client secret
On the OAuth App page, copy Client ID, then select Generate a new client secret.
Copy the generated client secret and store it securely. You need the complete secret in Coolify.
Configure GitHub in Coolify
In Coolify, open Settings > OAuth and find GitHub.
| Coolify field | GitHub value |
|---|---|
| Client ID | The GitHub OAuth App client ID. |
| Client Secret | The generated GitHub client secret. |
| Redirect URI | https://coolify.shadowarcanist.com/auth/github/callback |
Select Save, then turn on Enabled for GitHub.
Verify GitHub sign-in
Open the Coolify login page in a private browser window and select Login with GitHub. Authorize the OAuth App if GitHub asks, then confirm that Coolify opens the account with the same email address as the verified primary GitHub email.