Bitbucket

Integrating with Bitbucket allows you to use it as a git hosting provider and sign in to the workspace with your Bitbucket profile.

Create a new OAuth consumer in Bitbucket

Copy link

1. Sign in to your Buddy On-Premises instance as admin.
2. Add a new project and select Bitbucket as the provider.
3. Click Configure Bitbucket app and copy the Authorization Callback URL.

4. Sign in to your Bitbucket profile. Click your avatar icon in the bottom left and choose the workspace you want to integrate with Buddy.
5. Open the Settings tab and select OAuth consumers
6. Click Add a consumer

7. Configure the Bitbucket OAuth consumer:

   • Name → anything, eg. Buddy On-Premises
   • Callback URL → paste the callback URL copied from Buddy On-Premises
   • This is a private consumer → check this option

   Check the required permissions:

   • Account → Read
   • Repositories → Read
   • Webhooks → Read and write

8. Click Save to create the consumer.
9. Copy the Key and Secret of the newly created consumer.

10. Paste the Bitbucket OAuth consumer Key into the Buddy Client ID field.
11. Paste the Bitbucket Client into the Buddy Client Secret field.
12. Click Save changes and restart Buddy to apply the changes.