# Configuration

## Notifications setup

{% hint style="success" %}
Email notifications are enabled by default, with the root account email address set as the default recipient.
{% endhint %}

{% stepper %}
{% step %}
Login to [**XMS**](#user-content-fn-1)[^1], go to ⚙ **Settings** > **Email notifications** and switch the toggle to enable them.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FynVigvgRasAOOx419LhE%2Fimage.png?alt=media&#x26;token=c10c42f4-5ab4-417c-9501-225ee2f7a219" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **Enable notifications** tile to open the settings.
{% endstep %}

{% step %}
Expand the **Recipients** tab and select or enter the email addresses that should receive notifications.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FbIUQ4413he1YsKDLNjuT%2Fimage.png?alt=media&#x26;token=f5a8f196-d59c-4b51-b311-a19b50e9ed33" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Next, expand the **Email notifications** tab to configure additional settings, such as language and [notification types](#available-notifications-types).

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fd5YGIyrz6Z7h9MnNDN1o%2Fimage.png?alt=media&#x26;token=f9f4c5ec-4c2c-4b0b-be0f-05c0ed752917" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
To finish the email notifications setup, review your settings and click **Save**.
{% endstep %}
{% endstepper %}

***

## Available notification types

Below is a list of available notification types:

1. **Backup plan summary** — a notification is sent immediately after the backup task is finished or if it cannot be started. You can specify which task notifications you want to receive:
   1. **Successfully finished tasks** — notifies you about all successfully completed tasks.
   2. **Tasks finished with warnings** — notifies you about all tasks completed with warnings.
   3. **Failed tasks** — notifies you about all failed tasks.
   4. **Canceled tasks** — notifies you about all canceled tasks.
   5. **Tasks not started** — notifies you about tasks that could not be started.
2. **Restore verification summary** — sent after the data restoration process is completed; includes a detailed summary.
3. **Daily report** — an aggregate summary of all backup tasks performed during the day, sent at a manually defined time.
4. **SLA Reports** — monthly summary of backup correctness for the protected environment.
5. **Storage capacity notifications** — alerts you when storage usage exceeds the defined limit.

***

## Notifications per backup plan

{% hint style="danger" %}
Settings configured within a backup plan override the general settings.
{% endhint %}

Notifications can also be configured for individual backup plans—you don't have to enable them for all plans. If only certain plans should have notifications, enable them within the backup plan settings (**Backup plan settings** > **Advanced settings** > **Edit** > **Email notifications**).

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FRm5BNXQ49xStsrz63y9h%2Fimage.png?alt=media&#x26;token=77c8b6e7-9729-4529-bec5-55bbe3f93b17" alt=""><figcaption></figcaption></figure>

Similarly, if you want to maintain general notification settings but exclude specific plans, you can do so in the plan’s edit mode. Disabling notifications for a plan means that <mark style="color:$danger;">no notifications will be sent for that plan</mark>.

***

## Exipiring personal access tokens notifications

Email notifications are also available for expiring personal access tokens (**PAT**) to prevent backup tasks from failing due to an expired **PAT** used for integrating an organization with a **DevOps** platform (or at least to minimize the time needed to resolve this issue).

This configuration is organization-specific and can be adjusted in [**XMS**](#user-content-fn-1)[^1] under **DevOps** > your organization (i.e., **GitHub**) > **Edit** > **Email notifications**.

#### For proper setup, complete the following steps:

1. Enter the email address(es) that should receive notifications.
2. Select the preferred notification language.
3. Check **Expired Personal Access Token** checkbox.

{% hint style="warning" %}
This section is visible only for organizations that use **personal access tokens**.
{% endhint %}

{% hint style="danger" %}
For **Xopero ONE** on-premise application, notifications are sent only if an SMTP server is properly configured.
{% endhint %}

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FO4973JOFckZIF2k4lSzi%2Fimage.png?alt=media&#x26;token=871e3bfa-7984-49ba-b182-7c75f4debab9" alt=""><figcaption></figcaption></figure>

***

## Storage space notifications

In **Xopero ONE**, keeping data storage within capacity limits is crucial for maintaining efficient and reliable backup operations. When a repository approaches its storage limit, the service administrator should receive timely notifications which include the storage name and type, current usage, and remaining available space.

{% hint style="info" %}
Storage space notifications are sent every 24 hours until the issue with the exceeded storage space is resolved by reducing storage usage.
{% endhint %}

#### Notifications can be configured either globally (for the entire system) or individually for each storage:

**Global settings:**

1. Go to ⚙ **Settings** > **Email notifications** and click the **Email notifications** tab to expand it.
2. Scroll down to the bottom of the settings panel and switch the **Storage capacity notification** toggle to enable it.
3. Set the threshold at which the notification should be sent, then click **Save**.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fw4aUEIb1FLtF4iSMyu2y%2Fimage.png?alt=media&#x26;token=f5fe7e30-0703-487e-9e7b-7e1e8ed1eb8f" alt=""><figcaption></figcaption></figure>

**Storage-specific settings:**

1. Navigate to the Storages tab.
2. Select the specific storage and click the **edit** <img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2F3hAeYSIDYrQe23mtfuPV%2Fimage.png?alt=media&#x26;token=b13d8f71-0370-4cba-9266-516460c9563d" alt="" data-size="line"> icon next to it.
3. In the storage settings, enable and configure the **Storage capacity notification** option and click **Save**. These settings will override the global configuration for this specific storage.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FC0w0TDlSpOaMAh6Bzyit%2Fimage.png?alt=media&#x26;token=4e5f9d23-2a91-40cf-b27d-50554174a2d0" alt=""><figcaption></figcaption></figure>

[^1]: Xopero ONE Management Service