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.

Confluence Cloud accepts site and space imports from Confluence Server instances running version 5.10.x or later. If your instance is running an earlier version, you'll need to upgrade it before completing the site or space export.

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.

Multiple cloud apps?

Note: Site import is only available for Confluence-only instances. If you have multiple applications, such as Confluence and JIRA, you'll need to export and import spaces individually. See Import a Confluence Space.

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. 

  1. Choose  > General Configuration.
  2. Choose Backup & Restore in the left-hand panel.
  3. Choose Backup attachments.
  4. 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:

  1. Unzip the backup file.
  2. Sum the sizes of the XML files in the root directory of the zip file (this will be at least the file named entities.xml and 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...

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:

  1. Go to the Confluence download page and get the latest Confluence Server release for your operating system.
  2. Install Confluence as described in the Confluence Installation Guide.
  3. Import the data from your backup file (XML export) into your new Confluence installation (See Restoring a Site in the Confluence documentation).
  4. Log in to your new temporary Confluence instance, using the following credentials: 
    • Username: sysadmin
    • Password: sysadmin
  5. Change the password immediately after logging in.
  6. Export the spaces from the temporary site (See Export Content to Word, PDF, HTML and XML in the Confluence documentation).
  7. Import the spaces one by one into the destination Confluence Cloud instance. See Import a Confluence Space.

  8. 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.

If your backup zip file is larger than 100 megabytes, upload the file to your cloud side via WebDAV. If the zip file is smaller than 100 megabytes, you do not need to use WebDAV to upload data. This measurement is the size of the zip file, not the size of the data files inside it.

  1. Go to your Confluence Cloud site and choose  > General Configuration.
  2. Choose Site import.
  3. 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.
  4. Choose Import.

Add-ons

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!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport