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

Features requiring implementation

  • Creating issues not implemented yet, e.g. when there is a config error
  • Adding comments to PRs not implemented yet, e.g. when a PR has been edited or has a lockfile error