Configure Bitbucket OAuth

Create a Bitbucket Cloud OAuth consumer so Coolify can read the signed-in user's profile and confirmed primary email address.

Example data

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 fieldValue
NameA recognizable name such as Coolify.
Websitehttps://coolify.shadowarcanist.com
Callback URLhttps://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 fieldBitbucket value
Client IDOAuth consumer Key
Client SecretOAuth consumer Secret
Redirect URIhttps://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.

Troubleshooting

On this page