Skip to main content




Bitbucket is a Git-based VCS from Atlassian. You can use Bitbucket to drive insights into values such as:

  • Repository details in the Catalog
  • Scorecard rules

The Bitbucket integration can also be used to power Cortex with GitOps.


Cortex Cloud

When using Cortex Cloud, you can use our official Bitbucket App, which can be found under Settings → Bitbucket.


If you do not see the Settings page you're looking for in the sidebar, you likely don't have the proper permissions and need to contact your admin.

Cortex Server

If self-hosting Cortex, you'll need to use basic auth to connect to Bitbucket. Add your Bitbucket host, username, and password under Settings → Bitbucket by selecting On Prem in the dropdown.

We recommend setting up a bot account that has the desired access levels for the user.

If you’re using a self-hosted instance of Bitbucket, you’ll need to verify that your Cortex instance is able to reach the Bitbucket instance. See our IP Whitelist section for more.


Catalog Descriptor

repository: <workspace>/<repo>

The value for repository should be the workspace/repo as defined in Bitbucket.


  1. Rules are failing saying that I don't have file x, but it's definitely there!
    1. We always use the default branch for file existence checks. Make sure that the file is present in the default branch.