Skip to content

Bitbucket Cloud

Authentication

First, create an app password for the bot account. Give the bot app password the following permission scopes:

Permission Scope
account Account: Read
team Workspace membership: Read
issue:write Issues: Write
pullrequest:write Pull requests: Write

The bot also needs to validate the workspace membership status of pull-request reviewers, for that, create a new user group in the workspace with the Create repositories permission and add the bot user to it.

Let Renovate use your app password by doing one of the following:

  • Set your app password as a password in your config.js file
  • Set your app password as an environment variable RENOVATE_PASSWORD
  • Set your app password when you run Renovate in the CLI with --password=

Remember to:

  • Set the username for the bot account
  • Set platform=bitbucket somewhere in your Renovate config file

Unsupported platform features/concepts

  • Adding assignees to PRs not supported (does not seem to be a Bitbucket concept)
  • automergeStrategy=rebase not supported by Bitbucket Cloud, see Jira issue BCLOUD-16610

Open items

The below list of features were current when this page was generated on April 25, 2024.

Feature requests

  • Epic: Port GitHub API optimization to Bitbucket Cloud #27801
  • Support Jira Cloud Issues for Bitbucket.org #20568
  • Check branch status in "bitbucket.getPr()" #9618