> For the complete documentation index, see [llms.txt](https://helpcenter.xopero.com/xopero-one-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.xopero.com/xopero-one-en/backup-and-recovery/devops/bitbucket/integration/adding-bitbucket-organization-to-xopero-one.md).

# Adding Bitbucket organization to Xopero ONE

This article provides instructions for adding a Bitbucket organization to Xopero ONE.

## Using OAuth

{% stepper %}
{% step %}
Log in to [**XMS**](#user-content-fn-1)[^1], open the **DevOps** tab on the left side of the window, and select **Bitbucket** from the list.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FEleUIesq4Zhdqd92TWxC%2Fimage.png?alt=media&amp;token=a0bffef7-c6ce-41c1-b41b-f828c57e1169" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **Connect** button under **Bitbucket**.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fj4oQXfDNSaxsP5Hl2szW%2Fimage.png?alt=media&amp;token=c9cec222-bda4-4144-98fa-674a26cb699d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
A pop-up with **Bitbucket** login page will appear. Log in using your admin credentials and grant **Xopero ONE** access to the specified resources (when prompted).
{% endstep %}

{% step %}
Your **Bitbucket** organization has now been successfully added to **Xopero** **ONE**. Click **Custom policy** to adjust your backup policy settings, or click **Run backup** to execute the backup immediately using the current policy configuration.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FpVCDflb5Sknupm8ONGc4%2Fimage.png?alt=media&amp;token=e686d672-7fe5-4370-81ba-ee61fe3c20b6" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Using OAuth (Advanced Mode)

{% stepper %}
{% step %}
Log in to [**XMS**](#user-content-fn-1)[^1], open the **DevOps** tab on the left side of the window, and select **Bitbucket** from the list.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2F6OrpauQ7whhBee4PKLJd%2Fimage.png?alt=media&amp;token=1188b7a0-2254-4271-b135-c095aedcb927" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **advanced mode** link under **Bitbucket** and **Bitbucket DC** tiles.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FNcBgnKHwEO36wPXpKkYP%2Fimage.png?alt=media&amp;token=5f896f9e-b4d5-4e3a-b8e4-65a033b4bd61" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Set your authentication method.

1. In **Authentication**, select **Bitbucket**.
2. For **Connect using**, choose **OAuth App**.
3. In the **Settings** section, choose whether to enable **read-only mode** and whether **Xopero** should automatically add new repositories to your backup.

{% hint style="warning" %}
If the **Read-Only Access** switch is enabled, the recovery options will be disabled.
{% endhint %}

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FFaAq0dfsqtUgahKnrDrL%2Fimage.png?alt=media&amp;token=333399b0-308a-475b-b23c-68e443a97861" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure your repository sync and default worker. Specify hours for synchronization, or set a time interval for automatic updates.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2F0yk3HWZtjefkKJq3tJYA%2Fimage.png?alt=media&amp;token=61a44d19-7cca-4787-b3f9-dac5350ea0c4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Proceed** to complete adding your **Bitbucket** organization and grant **Xopero ONE** access to the specified resources (when prompted).

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FIkMKhXjzrOCXNfPy2X4w%2Fimage.png?alt=media&amp;token=fe24370e-fb22-42e7-93be-cc758aafd006" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Using an API token

{% stepper %}
{% step %}
Log in to [**XMS**](#user-content-fn-1)[^1], open the **DevOps** tab on the left side of the window, and select **Bitbucket** from the list.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2F6OrpauQ7whhBee4PKLJd%2Fimage.png?alt=media&amp;token=1188b7a0-2254-4271-b135-c095aedcb927" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **advanced mode** link under **Bitbucket** and **Bitbucket DC** tiles.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FNcBgnKHwEO36wPXpKkYP%2Fimage.png?alt=media&amp;token=5f896f9e-b4d5-4e3a-b8e4-65a033b4bd61" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Set your authentication method.

1. In **Authentication**, select **Bitbucket**.
2. For **Connect using**, choose **Username and App password**.
3. Enter your **Bitbucket** email address.
4. Add or select **App Password** that contains your API token from the **Password Manager**.
5. Choose whether **Xopero** should automatically add new repositories to your backup.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fg0Va0Xrk1vyKAZJ4IFzk%2Fimage.png?alt=media&amp;token=5ab29e01-aa8c-4415-9bbf-5770b1574bfa" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure your repository sync and default worker. Specify hours for synchronization, or set a time interval for automatic updates.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fxao0KkYPmITcz661POOw%2Fimage.png?alt=media&amp;token=eb8b7bc6-b555-4db7-b22b-4c036a87d414" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Proceed** to complete adding your **Bitbucket** organization and grant **Xopero ONE** access to the specified resources.
{% endstep %}
{% endstepper %}

***

## Additional browser permissions

When adding an organization, you may be prompted to grant additional permissions to the **Xopero ONE** application— make sure your browser allows **Xopero** to open pop-up windows.

<figure><img src="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/92JwIolq3nNcqZWYoX80/1.PNG" alt=""><figcaption></figcaption></figure>

Depending on your browser, you can either adjust the settings to allow pop-ups or permit the authorization window to open once.

<figure><img src="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/yMSRLkEP2cPAsr3MksgJ/Pop-ups%20xone.png" alt="Mozilla pop-up allowance"><figcaption></figcaption></figure>

***

## Useful links and items

{% embed url="<https://support.atlassian.com/bitbucket-cloud/docs/create-an-api-token>" %}

[^1]: Xopero ONE Management Service
