> 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/gitlab/integration/adding-gitlab-cloud-organization-to-xopero-one.md).

# Adding GitLab (cloud) organization to Xopero ONE

## Using OAuth <a href="#add_new_organization" id="add_new_organization"></a>

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

<figure><img src="/files/Xx3Wv2Hj5sFbPoBN8vZy" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="/files/ia2Jp59k5cZVEBWeZYuv" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
[In the window that pops-up](#additional-browser-permissions), log in with a user account which has the required permissions for the repositories or projects to protect. If your **GitLab** login session is active in a different tab, the login will complete automatically.

<figure><img src="/files/cfLwC65OgEq9PreWpzC4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Grant **Xopero ONE** access to the specified resources (when prompted).
{% endstep %}

{% step %}
Your **GitLab** 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/pRlwglxDNOE7sP9DjmfE" 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 **GitLab** from the list.

<figure><img src="/files/Xx3Wv2Hj5sFbPoBN8vZy" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **advanced mode** link under **GitLab** and **GitLab Self-managed** tiles.

<figure><img src="/files/la4T2JswwwssacGHN5qC" alt="" width="529"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Set your authentication method.

1. In **Authentication**, select **GitLab**.
2. For **Connect using**, choose **OAuth App**.
3. Choose whether **Xopero** should automatically add new repositories to your backup and whether it should include **GitLab** groups in the backup.

<figure><img src="/files/Do81HDgGxNAt3IQVh8P0" 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 %}
[In the window that pops-up](#additional-browser-permissions), log in with a user account which has the required permissions for the repositories or projects to protect. If your **GitLab** login session is active in a different tab, the login will complete automatically.
{% endstep %}

{% step %}
Grant **Xopero ONE** access to the specified resources (when prompted).
{% endstep %}

{% step %}
Your **GitLab** 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/GYl9oNN3BWAC6VV51VkE" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Using Personal Access Token (PAT)

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

<figure><img src="/files/Xx3Wv2Hj5sFbPoBN8vZy" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **advanced mode** link under **GitLab** and **GitLab Self-managed** tiles.

<figure><img src="/files/paawtK6XkK0P9kislcGS" alt="" width="529"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Set your authentication method.

1. In **Authentication**, select **GitLab**.
2. For **Connect using**, choose **Login and Personal Access Token**.
3. Enter your **username** or **email**.
4. Add or select **PAT** from the **Password Manager**.
5. Choose whether **Xopero** should automatically add new repositories to your backup and whether it should include **GitLab** groups in the backup.

<figure><img src="/files/TG5DfzMl8VmNRUxY0qlJ" 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 **GitLab** 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>

[^1]: Xopero ONE Management Service