Connect Bitbucket to a Project
This article is licensed under CC0 for maximum reuse.
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.
Select a branch from the "Branch" menu to view other branches in your repository. Master will be selected by default.
This article is licensed under CC0 for maximum reuse.