Migrate from Confluence Server to Cloud
Step 2. Upgrade your source Confluence site
The site importer requires that your source Confluence data is running version 5.10.x or later. If your instance is running an earlier version, you'll need to upgrade it. In order to keep your existing Confluence instance stable, you may want to perform this upgrade on a separate Confluence instance that's running on an evaluation license.
Step 3. Export the site content from the source Confluence site
Here we explain the process of creating an XML export from a Confluence Server instance.
- Choose Settings in the Confluence sidebar.
- Choose Backup & Restore in the left-hand panel.
- Choose Backup attachments.
- Choose Backup.
After the backup is complete, you'll see the link to the backup file (XML export).
Step 4. Check the size limits
Site import in Confluence Cloud is restricted to a maximum 200 megabytes for the uncompressed XML files inside the backup zip file. This is the 'data size' of the backup. There's no limit to the size and number of attachments.
When you try to do the import, Confluence will inform you if the backup data is too large.
To manually check the data size of the backup:
- Unzip the backup file.
- Sum the sizes of the XML files in the root directory of the zip file (this will be at least the file named
entities.xmland may also include XML files added by plugins).
What if the data size is OK?
If the data size of your site backup file is within the limits, import the site backup directly into the destination Confluence Cloud instance. See below.
What if the size limit is exceeded?
If the data size of your site backup file is too large, you'll need to import the content space by space and ensure your user data is imported, too.
If the source site is a Confluence Cloud instance, you can copy your data to a temporary installed site running Confluence Server 5.10 or later so that you can create the space exports:
- Go to the Confluence download page and get the latest Confluence Server release for your operating system.
- Install Confluence as described in the Confluence Installation Guide.
- Import the data from your backup file (XML export) into your new Confluence installation (See Restoring a Site in the Confluence documentation).
- Log in to your new temporary Confluence instance, using the following credentials:
- Change the password immediately after logging in.
- Export the spaces from the temporary site (See Export Content to Word, PDF, HTML and XML in the Confluence documentation).
Import the spaces one by one into the destination Confluence Cloud instance. See Import a Confluence Space.
- Import your users (See Integrate with G Suite).
Step 5. Import the site content into your Confluence Cloud site
If the data size of your site backup file is within the limit described above, import the site backup directly into the destination Confluence Cloud instance.
- Go to your Confluence Cloud site and choose Settings in the Confluence sidebar.
- Choose Site import.
- Specify your file using the Browse button.
- Choose Import.
After migrating your data, you'll need to install any compatible add-ons, like Questions for Confluence and Team Calendars for Confluence.
Please note that at present, there is no way to migrate your Questions for Confluence and Team Calendars for Confluence data from Server to Cloud.
Some third-party add-ons are only available for Server, and will no longer be available after you migrate. You can check whether your essential add-ons are available for Confluence Server, Cloud or both on the Atlassian Marketplace.