Bitbucket - Garth

This page covers on-prem (self-hosted) setup. You create your own Bitbucket OAuth consumer so authentication runs against your workspace. For the hosted SaaS integration, see Setup → Bitbucket.

You need admin access to the Bitbucket workspace to create an OAuth consumer.

Create the Bitbucket OAuth consumer

Open OAuth consumers

In Bitbucket, go to Workspace settings → OAuth consumers and click Add consumer.

Fill in the details

Field	Value
Name	`Garth Assist`
Callback URL	`https://<dns-host>/api/garth-assist/oauth/bitbucket/callback`

Replace <dns-host> with the DNS host of your on-prem Garth deployment — for example https://app.heygarth.ai/api/garth-assist/oauth/bitbucket/callback.

Select permissions

Grant the following permissions:

Permission	Access
Account	Read
Workspace membership	Read, Write
Projects	Read, Write
Repositories	Read, Write, Admin
Pull requests	Read, Write
Issues	Read
Pipelines	Read
Runners	Read

Save the consumer

Click Save. Expand the consumer to view its Key and Secret.

Store the Secret securely — treat it like a password.

Environment variables

Record the following values for your on-prem deployment:

Environment variable	Value
`BITBUCKET_CLIENT_ID`	The consumer Key
`BITBUCKET_CLIENT_SECRET`	The consumer Secret

​Create the Bitbucket OAuth consumer

​Environment variables

Create the Bitbucket OAuth consumer

Environment variables