Configure Clerk SSO
Configure Clerk as the identity provider for Coolify by creating a Clerk OAuth application with profile and email access.
Clerk SSO will be available in Coolify v4.3.0. The latest released version is v4.1.2, so this guide documents an upcoming feature that is not available in the current release.
Replace these values while following the guide:
- Coolify callback:
https://coolify.shadowarcanist.com/auth/clerk/callback - Clerk Base URL:
https://shadowarcanist.clerk.accounts.dev
Set up Clerk SSO
Create a Clerk OAuth application
Open the Clerk Dashboard OAuth applications page for the Clerk instance that will authenticate Coolify users.
Select Add OAuth application, enter a name such as Coolify, and include the email and profile scopes. Add openid only when another client needs OIDC; Coolify's Clerk integration requests email and profile.
Select Add.
See Clerk's OAuth application guide if the dashboard navigation differs.
Save the Clerk credentials
Copy the Client Secret from the creation modal and store it securely. Clerk does not show the complete secret again.
On the OAuth application's settings page, copy Client ID.
Register the Coolify redirect
In the Clerk OAuth application, add this value under Redirect URIs:
https://coolify.shadowarcanist.com/auth/clerk/callbackSave the application.
Use Clerk's user and organization controls to decide who may authenticate through the OAuth application.
Copy the Clerk Base URL
Open API Keys in the Clerk Dashboard and copy the instance's Frontend API URL. A development instance usually resembles:
https://shadowarcanist.clerk.accounts.devA production instance may use a custom Clerk domain. Use the origin shown by Clerk without /oauth/authorize, /oauth/token, or another path.
Configure Clerk in Coolify
Open Settings > OAuth and find Clerk.
| Coolify field | Clerk value |
|---|---|
| Client ID | Clerk OAuth application client ID |
| Client Secret | Clerk OAuth application client secret |
| Redirect URI | https://coolify.shadowarcanist.com/auth/clerk/callback |
| Base URL | Clerk Frontend API URL |
Select Save, then turn on Enabled for Clerk.
Verify Clerk sign-in
Open the Coolify login page in a private browser window and select Login with Clerk. Complete Clerk authentication, then confirm that Coolify opens the account matching the primary Clerk email address.
