Migrate from Confluence Cloud to Server

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

This page is for people who are currently using Confluence Cloud, and wish to move to Confluence Server (a self-hosted Confluence site).

For migrating from Confluence Server to Confluence Cloud, see Plan your Confluence Server to Cloud migration.

On this page:

You can migrate from Confluence Cloud to Confluence Server 6.0 or later only. You can't import Cloud data (either the whole site or individual spaces) into any earlier versions of Confluence. We recommend installing the latest version of Confluence Server. 

Confluence Cloud is typically ahead of Confluence Server, which means that some features may not be available after you've moved to Confluence Server.  

See Import a space from Confluence Cloud if you plan to migrate your spaces one by one.


Migration steps

To migrate from Confluence Cloud to Confluence Server:

  1. Export the data from your Confluence Cloud site, using the Confluence backup manager. 

    • To ensure all user data is included in the export, regardless of any profile visibility settings, a site admin should perform the export. 
    • For detailed instructions, see Create a site backup.
  2. Download the latest Confluence Server release. You will only be able to import your Cloud backup into Confluence 6.0 or later. We recommend always installing the latest release.
  3. Follow the Confluence Installation Guide for your platform to install Confluence.
  4. Import the data from your backup file (XML export) into your new Confluence installation - see Restoring a Site.
  5. Follow the steps on Restore Passwords To Recover Admin User Rights to start Confluence in recovery mode, and log in using the temporary account. 
  6. Create a new user account, and make it a member of the confluence-administrators group. This will be your system administrator account. 
  7. Stop Confluence, remove the recovery mode system property, then restart Confluence. 

Support, limitations, and recommendations

Please note the following about your new Confluence Server site.

  • If you're unable to remove the Jira Cloud application link from your Confluence after the import, you'll need to remove those references directly from the Confluence database as per this guide.
  • The User Management section might be missing due to CONF-35177 - Getting issue details... STATUS
    Follow the workaround notes on the issue to enable the feature again.
  • If your Confluence Cloud site has macros that depend on the Application Links back to a Jira Cloud instance, and you are migrating Jira as well, these references will need to be updated to work properly as per APL-1144 - Getting issue details... STATUS
    You can address that by either editing the XML prior to import, or by bulk editing those references in Confluence database as per this guide .
  • If you experience problems loading pages after the import, head to  > General Configuration to check your base URL as the port may have changed. 
  • If you find that some of your users' favorites (pages saved for later) are missing due to CONF-36348 - Getting issue details... STATUS . See How to restore missing favorites after import from XML for more information.
  • Confluence spaces are not automatically created when you create a new Jira project.
  • If you are unable to create or edit pages after migrating from Cloud to Confluence 5.10, follow the workaround in this issue to disable the specified dark features CONF-44335 - Getting issue details... STATUS . This issue doesn't affect Confluence 6.x versions.
  • Users in Confluence Cloud have the ability to change their profile visibility settings. To ensure all user data is included in the export, ask a site admin to perform the export.

Account visibility

In Confluence Cloud, people can choose not to make their profile information visible. This means when a Cloud site is imported into Server, user account information such as their full name, may not be included.

As long as you are logged in as a Site Admin when you complete the site export, email addresses will always be included, and used as the username when the user accounts are created. Users can then log in, and update their profile to provide the missing information. 

Marketplace apps

After migrating your data you will need to install any compatible apps, such as Questions and Team Calendars. 

(info) Please note that Questions and Team Calendars data will not be included in the migration. 

Some third party apps are only available for Cloud, and will no longer be available after you migrate. You can check whether your essential apps are available for Confluence Server, Cloud or both on Atlassian Marketplace. 

Database considerations 

If you are uncertain about which database to choose for your new Confluence installation, we recommend PostgreSQL - see Database Setup for PostgreSQL. The Confluence Cloud site runs on PostgreSQL, so there should be no compatibility issues.

If you choose another supported database, contact Support if you encounter any compatibility issues.

Confluence license

You will need a new license to migrate to Confluence Server. Your existing Confluence Cloud license cannot be used. You can get a new license at https://my.atlassian.com. You may also need new licenses for any paid Marketplace apps. 

Last modified on Aug 16, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.