# Adding GitLab (cloud) organization to GitProtect
## Using OAuth
{% 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.
{% endstep %}
{% step %}
Click the **Connect** button under **GitLab**.
{% 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 **Custom policy** to adjust your backup policy settings, or click **Run backup** to execute the backup immediately using the current policy configuration.
{% 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.
{% endstep %}
{% step %}
Click the **advanced mode** link under **GitLab** and **GitLab Self-managed** tiles.
{% 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.
{% endstep %}
{% step %}
Configure your repository sync and default worker. Specify hours for synchronization, or set a time interval for automatic updates.
{% 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.
{% endstep %}
{% step %}
Click the **advanced mode** link under **GitLab** and **GitLab Self-managed** tiles.
{% 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.
{% endstep %}
{% step %}
Configure your repository sync and default worker. Specify hours for synchronization, or set a time interval for automatic updates.
{% 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.
Depending on your browser, you can either adjust the settings to allow pop-ups or permit the authorization window to open once.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://helpcenter.gitprotect.io/backup-and-recovery/devops/gitlab/integration/adding-gitlab-cloud-organization-to-gitprotect.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.png?alt=media)
.PNG?alt=media)
