Bitbucket

Gitpod works with any public or private repository on Bitbucket.org.

Registering a Bitbucket Integration

To connect your Bitbucket account to Gitpod, you need to create a new OAuth consumer in Bitbucket and an associated Gitpod integration. The process is as follows:

On Gitpod’s Dashboard:

1. Navigate to the Organization settings using the organization dropdown in the top left corner.
2. Select Git Providers and click New Git Provider.
3. Choose Bitbucket Cloud as the provider type.
4. Copy the redirect URL from the form and follow the instructions below to create a corresponding OAuth consumer on Bitbucket.

On Bitbucket, follow instructions to create a new OAuth consumer with the following details:

• Name: Gitpod (or any other name you prefer)
• Callback URL: the redirect URL copied from Gitpod
• Permissions: Read for Account and Issues, Write for Pull requests

Starting Workspaces

To start a workspace from a Bitbucket project, click New Workspace ( CtrlCmd + O ) in the Gitpod Dashboard and select the project you’d like to start. For an even more seamless experience with Bitbucket, refer to our browser extension, which can add a convenient Gitpod button to every Bitbucket page.