Configuration settings for backing up repositories from Bitbucket.


Known limitations:


For the basics, please read the Sources section first.

For Bitbucket, the hoster entry in the config file needs to look like this:

hoster: bitbucket

SCM Backup will always backup a Bitbucket Workspace.

Bitbucket repository URLs look like this:…so the URL part directly behind is the workspace ID.
(The distinction between “users” and “organizations” - which most other hosters have, and which Bitbucket also had before they introduced workspaces - doesn’t really exist anymore)
  • To backup the repos of any workspace, the name entry in the config needs to be set to the workspace ID

  • If the workspace is the user’s “personal” workspace (workspace name is equal to username), set the type in the config to user. For any other workspace, set the type to org. 1


Without authentication, SCM Backup can only backup your public repositories.

In this case, it shows a warning:


To backup your private repositories as well, you need to authenticate with a user who has sufficient permissions to the workspace’s repositories.

Create an app password for SCM Backup for that user:

  1. In the user’s settings on Bitbucket, go to the App passwords area ( and create a new app password. Give it at least the following permissions:

    • Account: Read

    • Repositories: Read

    • Issues: Read

    • Wikis: Read and write (SCM Backup only needs to read, but there’s no separate “just read” permission)

  2. Put the username and the app password into the authName and password properties of the source in the config file.


    By default, a user’s workspace ID is equal to the user name, but it’s possible to change the workspace ID, so workspace ID and user name don’t match anymore.

    In this case, you need to set name to the workspace ID and authName to the user name.


      - title: some_title
        hoster: bitbucket
        type: org
        name: your_workspace
        authName: your_user_name
        password: your_app_password

    This will backup the repositories of the workspace your_workspace, but authenticate with the user your_user_name and the app password.



For what SCM Backup does, there’s no difference between users and workspaces. The actual backup will work with both types.

However, not all validations are done for both types, and if you set the wrong type, you may see misleading warning messages (example).