Configure Bitbucket OAuth
Create a Bitbucket Cloud OAuth consumer so Coolify can read the signed-in user's profile and confirmed primary email address.
Replace the example domain while following this guide:
- Coolify URL:
https://coolify.shadowarcanist.com - Callback URL:
https://coolify.shadowarcanist.com/auth/bitbucket/callback
Set up Bitbucket OAuth
Open OAuth consumers
Open Bitbucket Cloud, select the workspace that will own the integration, then go to Workspace settings > OAuth consumers.
You need permission to manage settings for the workspace. See Atlassian's Bitbucket OAuth documentation when the workspace navigation differs.
Add an OAuth consumer
Select Add consumer and enter:
| Bitbucket field | Value |
|---|---|
| Name | A recognizable name such as Coolify. |
| Website | https://coolify.shadowarcanist.com |
| Callback URL | https://coolify.shadowarcanist.com/auth/bitbucket/callback |
Under permissions, grant read access to the account and email address. Coolify requests the email scope and uses the confirmed primary email returned by Bitbucket.
Save the consumer.
Save the Bitbucket credentials
Expand the created consumer and copy its Key and Secret.
The Bitbucket Key is the OAuth client ID. Store the secret securely.
Configure Bitbucket in Coolify
Open Settings > OAuth and find Bitbucket.
| Coolify field | Bitbucket value |
|---|---|
| Client ID | OAuth consumer Key |
| Client Secret | OAuth consumer Secret |
| Redirect URI | https://coolify.shadowarcanist.com/auth/bitbucket/callback |
Select Save, then turn on Enabled for Bitbucket.
Verify Bitbucket sign-in
Open the Coolify login page in a private browser window and select Login with Bitbucket. Approve the consumer if requested, then confirm that Coolify opens the account matching the confirmed primary Bitbucket email.
