Documentation for Confluence 5.4.
Documentation for Confluence OnDemand and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata
Icon

CAUTION: Restoring a backup of an entire confluence site will:

  • Wipe out all Confluence content in the database. Please ensure that your database is backed up before you start.
  • Log you out after the restoration process. Please make sure you know the login details contained in the data that you are about to restore.

This page describes how to restore data from an XML backup file into an existing Confluence installation. If you want to restore data into a new site, follow the instructions on restoring from backup during setup.

You need System Administrator permissions in order to perform this function.

Notes before you start:

  • All content replaced. Restoring a site from backup will replace all your content, as described in the warning above.
  • Selective space restoration not possible. You cannot select a single space to restore from the entire site backup when the backup contains more than one space.
  • Backward version compatibility. Confluence supports backward compatibility for site backups (but not for space backups). You can successfully restore backups of a site from an older version of Confluence to a newer version of Confluence. You cannot restore backups from a newer version to an older version. For example, if you create a site backup in Confluence 2.4.3, it cannot be restored into a Confluence 2.2.2 site. It can however, be restored into 2.4.5 or 2.5.x, because 2.4.5 and 2.5.x are newer versions of Confluence.

(warning) The information on this page does not apply to Confluence OnDemand.

Restoring data from an XML backup

You can restore data from an XML backup file located somewhere on your local computer or a shared drive, or you can copy the XML file into the Confluence installation and restore it from there. The second option is recommended for large backup files. Both options are described below.

To restore data from an XML backup located outside Confluence:

  1. Choose the cog icon  at top right of the screen, then choose Confluence Admin.
  2. Choose Backup and Restore in the left-hand panel.
  3. Choose Choose File and browse for the backup file.
  4. Uncheck Build Index if you want to create the index at a later stage.
  5. Choose Upload and Restore.

To restore data from an XML backup located in your Confluence installation:

  1. Copy your XML backup zip file into the restore directory in your Confluence home directory. For example:
    • On UNIX: /opt/java/src/confluence/deployments/conf.atlassian.com/home/restore
    • On Windows: C:\Program Files\Atlassian\Application Data\Confluence x.x\restore
  2. Choose the cog icon  at top right of the screen, then choose Confluence Admin.
  3. Choose Backup and Restore in the left-hand panel.
  4. The zip file that you copied in step 1 will appear in the list of files under the heading Restore a backup from the Confluence Home Directory on your Confluence Administration Console. Select the zip file.
  5. Uncheck Build Index if you want to create the index at a later stage.
  6. Choose Restore.

Notes

  • Production backup strategy preferred. Atlassian recommends that you follow the Production Backup Strategy for your production Confluence site, because Confluence XML backups are not recommended for non-evaluation sites.
  • Restoring from other backups. If your daily backup zip files cannot be restored for some reason, but you have backups of both your database and your Confluence home directory, then it is still possible to restore from these backups.

11 Comments

  1. It Seems to me that backward compatibility is not fully usable :
    restoring a space from a 2.2.8 to a 2.4.4 gives : Restore denied. You can only restore space backups exported from the same major version (e.g. 2.2.x or 2.3.x).

    1. Please note that backward compatibility only applies when restoring a full site, not an individual space.

  2. Anonymous

    I just trying to upgrade from 2.7.1 to 3.0.0. But using the setup assistant to restore from a daily full backup archive i just got a

    [FileUnzipper] The file: exportDescriptor.properties could not be found in the archive: /foo/bar/confluence-backup.prod.20090610.zip

    and indeed, there isn't such a file. How to proceed?

    1. You may delete this thread. I discovered, that our backups are broken since about one month: The files exportDescriptor.properties and entities.xml are not include, just the attachements.

      This might be related with the version of the endorsed Java-XML-Libs, because currently the PDF export also fails with some XSLT-FO-exception.

      I'm testing the migration step with an older, but proper backup and this job starts running.

    2. Anonymous

      Hi,

       you can use alternative way of restoring jira.

      it is very simple way to restore from database back or alternative way.

      Please let me know if you don't know how to restore using alternative way you can get in touch with from dknitk@rediffmail.com

      Thanks,

      Dharmendra

  3. Hi - I have an XML zipped file from a GovDex (Australian Government Confluence site) Space Export. I am trying to import into a hosted Confluence site and get the error ...

    Restore denied. You can only restore space backups exported from the same major version (e.g. 2.2.x or 2.3.x).

    Any advice on how I can get this imported? I am trying to use the wiki convertor but Confluence is not one of the option. getting very frustrated! Please help.

    1. Hi Pat,

      The error message suggests that the space backup was created from a major version that is not as same as your Confluence version. For instance, the space backup could have been exported from Confluence 2.8.2 while your instance is Confluence 2.9.3.

      For more information on this compatibility, please refer to this page. It also suggests a workaround for this:

      You'll need to set up a test server of the same version and import the space, then upgrade your test installation so it's the right major version so that you can perform the export and import successfully. Otherwise, you can try to Change the version of the space export, but please try this on a test instance as well.

      Hope that helps.

      Cheers,
      Azwandi

  4. As a note the restore demo space is currently broken see/vote  CONF-29873 - Unable to restore demo-site.zip shipped with Confluence 5.1.4 Open

  5. Hello,

    I am using confluence 3.5.15 and I want to upgrade my Confluence into 5.3.2. My xml data backup size is 9GB. So is it possible to Restore of backup 9GB ?

    Best Regards,

    Siddheshwar Mhetre.

    1. Hi Siddheshwar,

      While it may be possible to restore a 9GB XML backup with the right hardware and memory allocation, we do not recommend that you use an XML restore as an upgrade method.  Instead, please refer to our Upgrading Confluence doc for the steps to perform an in-place upgrade.  It is far more reliable, and XML restores should not be used to upgrade between major versions.

      1. Hi Adam,

         Thanks for your answer. Because of memory size not able to restore the xml backup of confluence. Now its restoring fine.

        Thanks..(smile)

        Siddheshwar Mhetre