> 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

## 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="/files/Br6DcGqFThDItI3SaiCW" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="/files/P2PYuDUmte5wzpzXxeVK" 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="/files/ywnRBEnjPcs34GwVN8gD" 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="/files/GNRreHpQwNQVNhODtTHZ" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="/files/G1Wdzl8ctDWbSuHld3FO" 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="/files/DFIxjKn31LZVpE0f5dTH" 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="/files/xAwFfY1rsoXsKDIWJGP6" 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="/files/wLNqO0bqs9le3jK0XrXA" 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="/files/GNRreHpQwNQVNhODtTHZ" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="/files/G1Wdzl8ctDWbSuHld3FO" 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="/files/dBF2diH3JRNemcevumlN" 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="/files/PlCRf5BMIOIIPNjxBO9D" 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="/files/wlEd4lRBglPnofKhy6QP" 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="/files/iO3NRAUxU8qcTSWDUuEi" 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
