Restoring information from a native backup

Still need help?

The Atlassian Community is here for you.

Ask the community

Before you begin

Make sure that you have the password to a login in the backup file that has the Jira System Administrator global permission. Once the restoring procedure begins, all the existing data in the Jira application database is deleted, including all user accounts.

If you are restoring data from a Jira Cloud application site to a Jira Data Center application, please read Migrating from Jira Cloud to Jira Data Center applications.

 For all of the following procedures, you must be logged in with Jira Administrators global permission.

 1. Disable email sending/receiving

If you are restoring production data into a test Jira instance for experimentation purposes, you have to disable all Jira application's email features before you begin:

  • Disable email notifications — if Jira is configured to send emails about changes to issues, and you want to make test modifications to the copy, you should start Jira with the -Datlassian.mail.senddisabled=true flag.
  • Disable POP/IMAP email polling — if Jira is configured to poll a mailbox (to create issues from mails), you will have to disable polling on your test installation by setting the -Datlassian.mail.fetchdisabled=true flag.

Exactly how to set these flags is dependent on your particular application server, but for Jira, this is done by setting the DISABLE_NOTIFICATIONS environment variable before starting Jira (note, use instead of startup.bat if you are not using Windows):

set DISABLE_NOTIFICATIONS=" -Datlassian.mail.senddisabled=true -Datlassian.mail.fetchdisabled=true -Datlassian.mail.popdisabled=true"
cd bin

You could also try un-commenting the DISABLE_NOTIFICATIONS=" -Datlassian.mail.senddisabled=true -Datlassian.mail.fetchdisabled=true -Datlassian.mail.popdisabled=true" line from your /bin/setenv.bat file (/bin/ if you are not using Windows) and then running startup.

Follow these steps to restore data from a native backup.
  1. Stop Jira
  2. Replace the Jira Home directory with the backed up files.
  3. Re-apply any changes made in the Jira Install directory 


    This step is required only if something has changed since the backup, it shouldn't contain any actual data.

  4. Restore the database using native database tools (again this depends on the specific database type)
  5. Start Jira
Last modified on Dec 1, 2023

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.