mirror/coolify-docs
1
0
Fork 0
mirror of https://github.com/coollabsio/coolify-docs.git synced 2026-06-19 07:35:55 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(oauth): re-rewritten existing content for better readablility

Browse Source
This commit is contained in:
ShadowArcanist
2026-05-24 16:15:16 +05:30
parent 03cf886146
commit 4d864e6674
1 changed files with 34 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/docs/knowledge-base/oauth.mdx
+34 -10
View File
@@ -5,17 +5,41 @@ description: "Set up OAuth authentication with GitHub, GitLab, Google, Azure, or
# OAuth
You can login to coolify with email/password, or with OAuth.
Using OAuth, you can delegate authorization to get a user's email address to an external IDP provider. This lets coolify know that the user owns a specific email address associated with an existing coolify user. This is an alternative to forcing the user to provide a password to coolify to prove they own that same email address. Authorization servers supported by coolify include Azure, BitBucket, Github, Gitlab, and Google.
Using OAuth, you can delegate authorization to get a user's email address to an external IDP provider.
This lets coolify know that the user owns a specific email address associated with an existing coolify user.
This is an alternative to forcing the user to provide a password to coolify to prove they own that same email address.
Authorization servers supported by coolify include Azure, BitBucket, Github, Gitlab, and Google.
## Setup OAuth
To setup OAuth for a given IDP, you need to get a client id and a client secret from the authorization server to put into **YOUR_COOLIFY_DASHBOARD**/settings/oauth.
You'll also need to set a Redirect URI for the authorization server to send the user's data back to once they have authorized coolify to access their email address.
The Redirect URI to provide to the IDP should be in the format of **YOUR_COOLIFY_DASHBOARD**/auth/*PROVIDER*/callback for example.com : https://coolify.example.com/auth/google/callback
To setup OAuth for a given IDP, you need to get a client id and a client secret from the authorization server to put into `https://<your-coolify-domain>/settings/oauth`.
- [Google OAuth](https://support.google.com/cloud/answer/15549257)
- Authorized JavaScript origins should be **YOUR_COOLIFY_DASHBOARD**
- Authorized redirect URIs should be the redirect uri you set in **YOUR_COOLIFY_DASHBOARD**/settings/oauth for google. for example.com : https://coolify.example.com/auth/google/callback
- [Github OAuth](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app)
- Homepage URL should be **YOUR_COOLIFY_DASHBOARD**
- Authorization callback URL should be the redirect uri you set in **YOUR_COOLIFY_DASHBOARD**/settings/oauth for github. for example.com : https://coolify.example.com/auth/github/callback
You'll also need to set a Redirect URI for the authorization server to send the user's data back to once they have authorized coolify to access their email address.
The Redirect URI to provide to the IDP should be in the format of `https://<your-coolify-domain>/auth/<PROVIDER>/callback`
### Google OAuth
- Authorized JavaScript origins should be `https://<your-coolify-domain>`
- Authorized redirect URIs should be the redirect uri you set in `https://<your-coolify-domain>/settings/oauth` for Google.
<Callout type="info" title="Example">
For [Google OAuth](https://support.google.com/cloud/answer/15549257) the callback would be `https://coolify.example.com/auth/google/callback`
</Callout>
### Github OAuth
- Homepage URL should be `https://<your-coolify-domain>`
- Authorization callback URL should be the redirect uri you set in `https://<your-coolify-domain>/settings/oauth` for Github.
<Callout type="info" title="Example">
For [Github OAuth](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app) the callback would be `https://coolify.example.com/auth/github/callback`
</Callout>