OSF GuidesAdd-ons Storage add-onsConnect Bitbucket to a Project

Connect Bitbucket to a Project

Bitbucket is a web-based Git and Mercurial repository that allows you and your team members to store code. You can connect one Bitbucket repository to your OSF project. Different repositories can be linked to different components within the same project. The connection between Bitbucket and OSF is read-only, meaning files added to your Bitbucket repository will be accessible - but not editable - via OSF.

The Bitbucket add-on allows you to connect external content to OSF. This connection does not store or back up this content on OSF. To back up your content to OSF Storage, consider registering your project.

1. Enable Bitbucket in your project

First, open your project, then click the Add-ons tab in the navigation bar.

You will be taken to the "Add-ons" page for the project.

In the list of add-ons, click the Enable link next to Bitbucket.

The Bitbucket terms will appear.

Read the terms, then click Confirm button.

2. Configure Bitbucket

Find Bitbucket in the "Configure Add-ons" section, then click the Connect Account link

Log in to Bitbucket.

Then click the Import button in the modal.

3. Select a repository

Next, select a repository from the menu, then click Save.

Bitbucket will be connected to your project.

4. View branches

Select Bitbucket from the file tree, and a toolbar will appear.

Select a branch from the "Branch" menu to view other branches in your repository. Master will be selected by default.