> ## Documentation Index
> Fetch the complete documentation index at: https://ona.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket

Gitpod works with any public or private repository on [Bitbucket.org](https://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](https://support.atlassian.com/bitbucket-cloud/use-oauth-on-bitbucket-cloud/#Create-a-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` (`Ctrl/Cmd + 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](/classic/user/configure/user-settings/browser-extension), which can add a convenient Gitpod button to every Bitbucket page.