# Password reset

## If you have access to your GitProtect Management Service <a href="#on-premise" id="on-premise"></a>

{% stepper %}
{% step %}
Login to **Management Service**, open **Settings** (gear ⚙️ icon in the bottom-left corner) and select **Accounts**.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FoPb3KQcRFyNmspvGab1y%2Fimage.png?alt=media&#x26;token=e339fc45-dd1e-452c-8f11-931efe6e1238" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Find your root account and click the **edit** (✏️) icon.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FkfWEJdJqM65FswjzXPX5%2Fimage.png?alt=media&#x26;token=2604e639-ce4b-4285-85c7-844931c25775" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Enter your old password and your new password in the correct fields, then click **Change**.

{% hint style="warning" %}
Keep in mind that when you're creating a new root account password you <mark style="color:red;">**have to meet the password complexity requirements**</mark>.
{% endhint %}

{% hint style="danger" %}
By default, the system remembers **three most recently used passwords**, which **cannot be used again when creating a new password —** the number of previously used passwords that must remain unique can be adjusted in the **Unique new passwords** section under ⚙️**Settings** > **Advanced**.
{% endhint %}

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FlEj9Ag0mfhq9a2dNeB9Y%2Fimage.png?alt=media&#x26;token=dd12e35b-6cfd-4ebd-8f34-b2014cb5a309" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Hit the **Save** button to finish. Your password should now be successfully changed.
{% endstep %}
{% endstepper %}

***

## If you don't have access to your GitProtect Management Service

{% stepper %}
{% step %}
Open your **Management Service** login page and click **Forgot password?** link under credentials fields.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2F5qjUrkEoyI3PzAzAx952%2Fimage.png?alt=media&#x26;token=49f4ce94-fa5d-46e2-924a-e23f3f947c12" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Enter the email address associated with your root account and hit **Send me a recovery link** button.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FDo8MXdV9Uk7cvPaivwXy%2Fimage.png?alt=media&#x26;token=638e0c89-fe0e-4c9e-a1f2-6176016e1708" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
You will see a message confirming the password reset has been initiated. Follow the next steps based on your deployment model (SaaS or on-premise):

**a. For SaaS model:**

1. If the password reset was initiated correctly you will see the following message:

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FoDCKdhfYH6IK67nF1m8B%2Fimage.png?alt=media&#x26;token=231bb398-80ba-4589-a165-4923c006c5ba" alt=""><figcaption></figcaption></figure>

2. Open your inbox, find the email from **GitProtect & GitProtect.io** and click the **Password reset** button.
3. Set a new password for your root account and press **Save**.

{% hint style="warning" %}
Keep in mind when you're creating a new root account password you <mark style="color:red;">**have to meet the password complexity requirements**</mark>.
{% endhint %}

{% hint style="danger" %}
By default, the system remembers **three most recently used passwords**, which **cannot be used again when creating a new password —** the number of previously used passwords that must remain unique can be adjusted in the **Unique new passwords** section under ⚙️**Settings** > **Advanced**.
{% endhint %}

4. You will receive a confirmation once the password is changed successfully.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FWwRfoZPFmIVh9CtRpnO9%2Fimage.png?alt=media&#x26;token=1d79c6a5-c0bf-46e0-b5bf-53c8a598b1e9" alt=""><figcaption></figcaption></figure>

**b. For on-premise model:**

{% hint style="warning" %}
The following steps apply to the on-prem model <mark style="color:red;">**without a configured SMTP server**</mark>. When the SMTP server is configured, the on-prem version processes the password reset via email, similarly to the SaaS model.
{% endhint %}

1. Once you see the following message, your root account password is already changed.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fgit-blob-7a5472ac3b4c4eb07c735ae767735d6262d26e6b%2Fimage%20(451).png?alt=media" alt=""><figcaption></figcaption></figure>

2. You can find it in a .txt file in the following path:

> <sub><kbd>C:\ProgramData\GitProtect\GitProtect Backup\&Recovery Service\pwdreset<kbd></sub>\ <sub><kbd><email@domain.com.txt><kbd></sub>
> {% endstep %}
> {% endstepper %}
