Migrate from Confluence Server to Cloud
You can import all the content from another Confluence instance into your Confluence Cloud instance. This will replace all content and users in your Confluence Cloud instance, including:
- The content of all spaces exported from the other site.
- The users exported from the other site, including all administrators and non-administrators.
- The groups, and user memberships of those groups, exported from the other site.
If you want to import content space by space, instead of replacing the entire site, see Import a Confluence Space.
On this page, we will use the term 'source Confluence site' or 'source site' to mean the Confluence installation you are copying the information from. The 'destination site' is the Confluence Cloud instance you are copying the information to.
Step 1. Back up your existing Confluence Cloud site
The import will remove all data on your destination site, including content, users, and groups. We strongly recommend you make a backup copy of the destination site and save the backup file on your local file system. See Create a site backup.
On this page:
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 > General Configuration.
- 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 Importing Users).
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 > General Configuration.
- Choose Site import.
- Do either of the following:
- If you uploaded the archive via WebDAV, choose the file in the WebDAV Files field.
- Otherwise, 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.
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.
Was this helpful?
Thanks for your feedback!