Skip to main content
This feature is available to customers on specific editions. Visit Matillion pricing to learn more about each edition.
Connecting a Bitbucket cloud repository to is a straightforward process. Read on to learn what steps are required.
These setup steps detail what is required to connect a Bitbucket cloud project to . While it may be possible to connect using Bitbucket Data Center, this is not yet officially supported.

​
1. Create a new Bitbucket repository (optional)

Once signed in to your Bitbucket account, create a new project in your preferred workspace. We strongly recommend also initializing the repository with a README file. The repository for the project will be created with main as the default branch.
A branch called main is required, but it does not have to be the default branch.

​
Want to use an existing repository?

If you already have an existing Bitbucket repository, you can connect it to your project, too. Once you complete the authorization process between Bitbucket and Matillion, you will see any existing repositories in the workspaces that you have the permission to view the source code of.
For users with access to a large number (> 100) of repositories, this may take a short while to load. This is a known degradation, with improvements actively being worked on to mitigate the issue.
If you choose an existing repository to connect to , then all existing branches will be visible in your branch list in the Branches tab.

​
2. Set up Bitbucket roles and permissions

There are numerous levels at which to control access of users to your Bitbucket repositories, whether that is on a specific repository, at a project level to control a collection of repositories, or across an entire workspace. These controls can be applied to an individual user, or to a “group” of users. This is not intended to be a primer on Bitbucket access control; however, you can read more about granting Bitbucket repository access in the Atlassian documentation. Here you can also find an explanation for configuring Bitbucket project access, which differs slightly to individual repositories. For a user to select a Bitbucket repository as a destination in , they will need to be considered a Contributor, meaning they are able to write to a repository whether it is public or private. Consequently, repositories for which a user only has read-only access will not appear for selection in .

​
3. Set up project access in (optional)

If you wish to collaborate with other users on the same project, add them to your project by following the instructions at Project roles. Make sure these users are members of the same Bitbucket workspace that contains the Bitbucket repository you have connected to your Matillion project, and that they have write access to the repository through their user or group permissions.
Troubleshooting Bitbucket repository connections