Skip to main content
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

1

Open OAuth consumers

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

Fill in the details

FieldValue
NameGarth Assist
Callback URLhttps://<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.
3

Select permissions

Grant the following permissions:
PermissionAccess
AccountRead
Workspace membershipRead, Write
ProjectsRead, Write
RepositoriesRead, Write, Admin
Pull requestsRead, Write
IssuesRead
PipelinesRead
RunnersRead
4

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 variableValue
BITBUCKET_CLIENT_IDThe consumer Key
BITBUCKET_CLIENT_SECRETThe consumer Secret