Exporting issues

 

You can create a backup of your JIRA Cloud site if you want to import cloud data into a server installation or another site, or if you want to maintain occasional offline backups. Note that the Atlassian Cloud service takes backups for your instance every 24 hours for purposes of application recovery (not for rolling back application data).

You can backup and export the following data from your JIRA Cloud site: 

  • Issues
  • Users and user group settings
  • Issue attachments, user avatars, and project logos (if selected)

On this page:

How to create a backup

You can generate a new backup every 24 hours from the time the previous backup has finished. Note that JIRA only stores one backup file at a time, and any existing existing backup will be overwritten by a new one. To generate a backup:

  1. Choose > System

  2. In the Import and Export section, click Backup manager.

  3. Check the additional files option if you want to include issue attachments, user avatars, and project logos in the export.

  4. Select the type of backup:
    • If you will restore the data to a cloud instance, select Create Backup for Cloud
    • If you will to restore the data to a server instance, select Create Backup for Server

After the backup is complete, click the file link to download the backup.

 

  Troubleshooting: If you can't find the Backup Manager...

In some cloud sites where the Backup Manager menu does not appear, you can use one of the following workarounds to access it:

https://<domain_name>.atlassian.net/plugins/servlet/ondemandbackupmanager/admin

https://<account_name>.jira.com/plugins/servlet/ondemandbackupmanager/admin

How to structure the export file

Once you have generated and unzipped a backup file, you should have an output similar to the following:

JIRA-backup-20161021
├── activeobjects.xml
├── entities.xml
├── data
│   ├── attachments
│   └── avatars
└── logos

Note that database data is stored in both activeobjects.xml and entities.xml. Issue attachments, user avatars, and project logos are stored in corresponding directories. If you don't want to import attachments, avatars, or logos to your new JIRA Cloud site, you can remove the corresponding directory and then zip the modified directory tree before importing. 

How to import backup data into JIRA Cloud

  1. Structure your export file as mentioned above
  2. Follow the instructions on importing issues
  3. After the import, log into your new JIRA Cloud site with the same admin account you used to log into your original site. Cross-application links (links to a source file page from a JIRA issue) will point back to the corresponding source location after the import.

How to import backup data into JIRA Server

  1. Structure your export file as mentioned above
  2. Follow the instructions on the Migrating from JIRA Cloud to JIRA Server page.
  3. After the import, log into your JIRA Server instance with the sysadmin username and corresponding password. Make sure to change your password after you log in. Cross-application links (links to a source file page from a JIRA issue) will point back to the corresponding source location after the import.

Note that the sysadmin user is created automatically during the backup process. This user is created to allow you to log in with the necessary JIRA System Administrator permission (a server-specific permission not available in the cloud) after restoring data in JIRA.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport