# Additional GitLab credentials

## GitLab account preparation <a href="#additional_account" id="additional_account"></a>

The best way to add an additional account to your **GitLab** environment is by adding a new user to the dedicated **group**. This way, the added user automatically gains access to all projects within the group.

Alternatively, you can add a user to individual projects separately.

💡 For detailed information about organization membership, see the [official **GitLab** documentation](https://docs.gitlab.com/user/project/members).

***

## Adding GitLab credentials to Xopero ONE

{% hint style="danger" %}
Adding additional credentials in **Xopero ONE** does not automatically integrate them into backup tasks— you <mark style="color:$danger;">**must**</mark> enable new credentials for use in a backup plan.
{% endhint %}

{% stepper %}
{% step %}
Login to [**XMS**](#user-content-fn-1)[^1], open the **GitLab** tab and click **Edit** in the bottom-left corner of the selected **GitLab** repository tile.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FVsiZMRyyTilFpT1MIKbb%2Fimage.png?alt=media&#x26;token=f2050fd9-aeec-4028-bc10-7ac27addb65f" alt="" width="354"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Go to the **Additional credentials** section and click it.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FHylzSKXxuNkvGYRQYTal%2Fimage.png?alt=media&#x26;token=d94e7435-1294-4e9c-b32a-358853d2bc63" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **Add new** button, enter the credentials, and then click **Save** to finish.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FEEhGeItNRlphjr8Fj04Q%2Fimage.png?alt=media&#x26;token=1381ee76-2c05-43f2-aeee-e5a6802602d0" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Enabling GitLab credentials for backup

{% stepper %}
{% step %}
In [**XMS**](#user-content-fn-1)[^1], open the **Plans** tab and click **Add plan**, or select **Edit plan** if you already have one.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fg8QUg1HAuziERAZwKcIv%2Fimage.png?alt=media&#x26;token=d22ed15b-8063-4efb-ae79-a254ff7d31e0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Scroll down to **Advanced settings**, click **Edit**, and enable the **Additional git credentials** switch.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FwJO21QpR2z3bzOnH47aD%2Fimage.png?alt=media&#x26;token=9bdabec6-d9a0-4fee-8300-7873b23235ad" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
The system will display all additional accounts available for the selected organization. Toggle the switch **ON** next to the accounts you want to use, and then click the **Save** button.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FiXMYXRtHFj74Wdp9RhCX%2Fimage.png?alt=media&#x26;token=c6fb127b-405f-45fe-9407-61bda5aea8b8" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Back in the **Edit backup plan** panel, click the **Save** button to save your backup plan settings. The backup plan will now run using the selected additional **GitLab** accounts.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FcEoIAnYGqDv3Eq6fU4vU%2Fimage.png?alt=media&#x26;token=94d0711c-1739-446f-acd0-6a676f71aece" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

[^1]: Xopero ONE Management Service
