• You should be the Workspace Admin to be able to see the GitOps sidebar item and add Git Provider.
  • You should have a repository created on

Step 1 - Setting up

Go to Settings from the top nav bar, select GitOps under Workspace, and then click Add a Git provider.


Both the instance URL and Display name are pre-populated for you.


Step 2 - OAuth consumer info


In this step, you need to register "Bytebase" as a Bitbucket workspace-wide OAuth consumer. This can only be done by an workspace admin on If you are not, you will need to ask the admin to follow Step 2.1 to register the consumer and provide the Key and Secret. Then you may continue onwards from Step 2.2.

Step 2.1 - Register Bitbucket workspace-wide OAuth consumer (performed by workspace admin)

Login as an workspace admin user to the The account must be an workspace admin of the Bitbucket workspace (able to access the Workspace settings page):


Go to OAuth consumers from the sidebar, then click Add consumer button.


Fill in the form with the provided info on the Bytebase setup wizard:

  • Name: Can be other names than "Bytebase", as long as the workspace admin can identify this consumer is for "Bytebase"
  • Callback URL: Begins with the host:port where the Bytebase console is running, and followed by /oauth/callback. This is the URI Bitbucket uses to callback Bytebase during the OAuth flow.
  • Permissions: Account > Read, Webhooks > Read and write, Repositories > Write

Click the Save button after filling the info on and you will see a created consumer, along with its Key and Secret.

Step 2.2 - Verify setup

Fill in the Application ID and Secret onto the corresponding fields on the Bytebase setup wizard:


After you click "Next", Bytebase will kick off an OAuth flow to verify the setup. If you are not currently logged on You will be prompted to login to complete the OAuth.


If you get an error in the OAuth popup window. Please double-check the following info:

  1. The Callback URL of the registered Bitbucket OAuth consumer matches exactly to the Callback URL shown on the Bytebase wizard.
  2. The Key and Secret of the registered Bitbucket OAuth consumer matches exactly to the filled Application ID and Secret on the Bytebase wizard.

Step 3 - Confirm and add

When everything is setup properly, you will be informed that the setup is correct. Click "Confirm and add".


Now you have successfully added a Git provider, developers can now link their Bytebase projects with one of their owned repositories from this Git provider.

Edit this page on GitHub

Subscribe toย Newsletter

By subscribing, you agree with Bytebase's Terms of Service and Privacy Policy.