# Creating a backup plan

**Creating a Jira backup plan in Xopero ONE enables administrators to define how and when Jira data is protected within the backup environment, including selecting the backup scope and configuring the schedule and retention policy.**

***

## Granular backup plan setup <a href="#backup_plan_creation" id="backup_plan_creation"></a>

{% hint style="danger" %}
Due to **Atlassian** API changes that took effect on March 30, 2026, the disaster recovery backup and restore functionalities are no longer available. **To ensure continued protection of your Jira data, please switch to the granular backup plan.** Data previously protected with disaster recovery backups can still be restored using the disaster recovery or granular recovery option.
{% endhint %}

**Granular backup plan** focuses on individual **Jira** components, such as issues (work items), spaces (projects), and attachments, allowing you to restore specific items when needed.

The following steps demonstrate how to create a **Jira** granular backup plan using **Xopero ONE Management Service**.

{% stepper %}
{% step %}
Open the **Backup** tab (**Plans** > **Backup**) and click the **+ Add plan** button in the top bar.
{% endstep %}

{% step %}
Select **Jira** from the list.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FTNrvalHB4zL15RUj5nmF%2Fimage.png?alt=media&#x26;token=d76ba66c-64ad-4286-8dee-c3ab27d8b3d2" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Select the **Jira** environment you want to include in the backup and how **Xopero ONE** will capture the **Jira** data:

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FTP1eR4VVpOVoXaIkHNF7%2Fjirabackupcreategran.png?alt=media&#x26;token=68634ca4-122a-490e-a39e-41028544d317" alt=""><figcaption></figcaption></figure>

1. **Protect all:** protects the entire **Jira** organization.
2. **Select projects:** protects only selected spaces (projects) and their metadata.
3. **Set rules:** captures data to protect based on the specified rules:
   1. A granular **Jira** backup based on rules defined by the space (project) name **behaves the same way as repositories in Git-type projects**. For example, the rule `git` will match only the space with the exact name git. To create name-based rules, you can use the following wildcards:
      * `*` represents any number of characters. For example, the rule `*git*` will match spaces with names such as my-git-1, git, git-100, and similar.
      * `?` represents a single character. For example, the rule `git-300?` will match spaces with names such as git-3001, git-3002, and git-300m.
        {% endstep %}

{% step %}
Set up a name for your backup plan.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FHKhJKFeqjwWTEZnvBLnL%2Fimage.png?alt=media&#x26;token=d363a7dd-41d8-4e06-8069-7f46cef19b1e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
In **Data to protect** section, click **Edit** to configure the data that you want to back up. Here, you can also change the default backup agent (worker), which is directly responsible for backing up your **Jira** data.

{% hint style="success" %}
You can deploy multiple agents and assign different agents to each backup plan.
{% endhint %}

{% hint style="info" %}
In the **Additional data** section, under **Assets**, you can enable including object activity history in the backup.
{% endhint %}

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FpA6XqPKhXPI8DKP9sK4u%2Fimage.png?alt=media&#x26;token=30f791bf-a46a-4c87-b5b5-dfb80e3faa41" alt=""><figcaption></figcaption></figure>

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FZ8mczLHkzcPsFIkHnyI0%2Fjiraplandatatoprotect.png?alt=media&#x26;token=4789a291-2d11-4189-ad17-82104ebbd3c7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Select one of the data stores assigned to your **Xopero ONE** instance to use as the backup storage.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FumtHKzPckN0eIq7b62BR%2Fimage.png?alt=media&#x26;token=049b56e8-44c1-4fa9-9f13-70665a025719" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Customize the scheduler and specify the retention period for your data.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FIpvIKRJHmv6H9TKfV1BQ%2Fimage.png?alt=media&#x26;token=6cc77531-3b8c-4b8d-97be-79c33aa2ab8d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Adjust the advanced settings, such as encryption, error handling, or bandwidth limits, to meet your organization's requirements.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FusGRSrliXHVrO2VU5biT%2Fimage.png?alt=media&#x26;token=596ebc82-b55e-4c4c-b9f7-d6dfe2dc0d6d" alt=""><figcaption></figcaption></figure>

1. **Encryption**: lets you secure your backup copy with encryption.
2. **Compression**: lets you compress and reduce copy size.
3. **Deduplication:** allows you to reduce the backup size.
4. **Error handling**: allows you to specify how to handle potential backup operation errors. Includes an option to skip corrupted issue attachments during backup.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fe0jw7A8FGJNwbM5ENc0L%2Fimage.png?alt=media&#x26;token=02c12000-d34a-4808-b671-db3651d073ab" alt=""><figcaption></figcaption></figure>

5. **Exclude Jira issues:** excludes **Jira** issues (work items) from backup according to defined rules.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FgRxJbgvy7V6odnRpQxsS%2Fimage.png?alt=media&#x26;token=e2b48c8b-7b88-4759-92c0-b77772a7fbc0" alt=""><figcaption></figcaption></figure>

6. **Bandwidth limit:** allows you to reduce network usage and limit network speed during backup.
7. **Backup scripts:** enables configuring pre/post scripts executed during backup.
8. **Task balancing:** balances backup speed and CPU load.
9. **Prevent system sleep:** prevents your system from suspending while a backup is in progress.
10. **Email notifications:** lets you set up email notifications and its recipients.
    {% endstep %}

{% step %}
Review your configuration and click **Save** to create the backup plan, or **Save\&Run** to start the first backup run immediately.
{% endstep %}
{% endstepper %}

***

## Useful links and items

{% content-ref url="process-overview" %}
[process-overview](https://helpcenter.xopero.com/xopero-one-en/backup-and-recovery/jira/backup/process-overview)
{% endcontent-ref %}

{% content-ref url="../../../management/scheduler-and-retention" %}
[scheduler-and-retention](https://helpcenter.xopero.com/xopero-one-en/management/scheduler-and-retention)
{% endcontent-ref %}
