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

# Adding GitLab (cloud) organization to GitProtect

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

{% stepper %}
{% step %}
Log in to **GitProtect Management Service**, open the **DevOps** tab on the left side of the window, and select **GitLab** from the list.

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

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

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

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

{% step %}
Your **GitLab** organization has now been successfully added to **GitProtect**. 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/rdzZgGddB9ezSVUNOiyu" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Using OAuth (Advanced Mode)

{% stepper %}
{% step %}
Log in to **GitProtect Management Service**, open the **DevOps** tab on the left side of the window, and select **GitLab** from the list.

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

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

<figure><img src="/files/XSUkLkdXLPTSnoBiKnad" 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 **GitProtect** should automatically add new repositories to your backup and whether it should include **GitLab** groups in the backup.

<figure><img src="/files/jnNdLJCRWBPz3NZBFutV" 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/XIuxrN7gEzCgmviJycxw" 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 **GitProtect** access to the specified resources (when prompted).
{% endstep %}

{% step %}
Your **GitLab** organization has now been successfully added to **GitProtect**. Click **Customize policy** to adjust your backup policy settings, or click **Run now** to execute the backup immediately using the current policy configuration.
{% endstep %}
{% endstepper %}

***

## Using Personal Access Token (PAT)

{% stepper %}
{% step %}
Log in to **GitProtect Management Service**, open the **DevOps** tab on the left side of the window, and select **GitLab** from the list.

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

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

<figure><img src="/files/M9GINlMt4kQut0DRTOES" 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 **GitProtect** should automatically add new repositories to your backup and whether it should include **GitLab** groups in the backup.

<figure><img src="/files/9qZ357Bvr6RfbT85FElG" 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/XIuxrN7gEzCgmviJycxw" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

***

## Additional browser permissions

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

<figure><img src="/files/ijoEjZ0DVf07VgKDRfuq" 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/B6FLPvwKpGiF4hnKl3nm" alt="Mozilla pop-up allowance"><figcaption></figcaption></figure>
