Migrating from Confluence Cloud to Confluence Server

This page is for people who are currently using Confluence Cloud, and wish to move to Confluence Server (a Confluence installation hosted on your own servers).

For migrating from Confluence Server to Confluence Cloud, see Importing wiki data.

On this page:

To migrate from Confluence Cloud to Server you'll need to download and install a special Confluence Cloud release and then move your data from your Confluence Cloud site to your newly installed site.

Confluence Cloud is typically ahead of Confluence Server, which means you can't move your data from Confluence Cloud to a site installed from the standard Confluence Server download because backups taken from Confluence Cloud are only compatible with the current Cloud release (for example, 'Confluence 5.5-OD-23'). 

Note: It is important that you export your data and download Confluence on the same day to ensure that your data and your Confluence installation use the same version.

Migration steps

To migrate from Confluence Cloud to Confluence Server:

  1. Export the data from your Confluence Cloud site, using the Confluence backup manager. 
    • For detailed instructions, see Exporting wiki data.
    • You now have an XML export of your Confluence data.
  2. Download the current Confluence Cloud release.
    Go to the Confluence Cloud download page and get the release for your operating system:
    • For Windows 64-bit: Get '5.x-OD-x - Windows Installer (64 bit)'
    • For Windows 32-bit: Get '5.x-OD-x - Windows Installer (32 bit)'
    • For Linux 64-bit: Get '5.x-OD-x - Linux Installer (64 bit)'
    • For Linux 32-bit: Get '5.x-OD-x - Linux Installer (32 bit)'
    • To install Confluence from an archive on UNIX or Mac OS X: Get '5.x-OD-x - Standalone (TAR.GZ Archive)'
    • To install Confluence from an archive on Windows: Get '5.x-OD-x - Standalone (ZIP Archive)'.
  3. Follow the Confluence Installation Guide to install Confluence.
  4. Import the data from your backup file (XML export) into your new Confluence installation - see Restoring a Site.
  5. Log in to your new Confluence site, using the following credentials: 
    • Username: sysadmin
    • Password: sysadmin
  6. Change the password immediately after logging in.

Support, limitations, and recommendations

Please note the following points about your Confluence site installed from an Cloud release.

Upgrading to a standard Confluence Server release

You must upgrade to a standard Confluence Server release as soon as one is available. For example if you installed 5.5 OD-23, you must upgrade to 5.6 when it is released. Cloud ('OD') releases are supported, but only until the next Confluence Server release is available.

Third-party add-ons

Because Confluence Cloud is typically ahead of Confluence Server, some third-party add-ons may not be compatible with the Cloud release. You may have to wait until you upgrade to the next full Confluence Server release before installing incompatible add-ons. Any add-ons that you were already using in Confluence Cloud will be compatible.

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 with other supported databases.

Confluence license

You will need a new license to migrate to Confluence Server. Your existing Cloud license cannot be used.  You can get a new license at https://my.atlassian.com.

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