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 or across major versions. 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. Importing an old XML backup file to a new major version (for example, Confluence 3.5 to Confluence 4.0) is not supported.
- XML backups should not be used to upgrade Confluence. Upgrade Confluence by following: Upgrading Confluence.
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:
- Choose Backup and Restore in the left-hand panel.
- Choose Choose File and browse for the backup file.
- Uncheck Build Index if you want to create the index at a later stage.
- Choose Upload and Restore.
To restore data from an XML backup located in your Confluence installation:
- 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
- Choose Backup and Restore in the left-hand panel.
- 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.
- Uncheck Build Index if you want to create the index at a later stage.
- 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.