Moving to Confluence Data Center

This page outlines the process for upgrading an existing Confluence Server site to Confluence Data Center.

On this page:

If you're installing Confluence for the first time (you don't have any existing Confluence data to migrate), see Installing Confluence Data Center.

If you're wanting to switch back Confluence Server, see Moving from Data Center to Server.

Your Confluence license determines the type of Confluence you have: Server or Data Center. Confluence will auto-detect the license type when you enter your license key, and automatically unlock any license-specific features.

Not sure if you should upgrade from Confluence Server to Data Center? Learn more about the benefits of Confluence Data Center.

Before you begin

This guide applies to Confluence 7.2 or later. The migration process is different if you're running an earlier version of Confluence. Check the instructions outlined in our previous migration guide.

Requirements

To use Confluence Data Center you must:

If you plan to run Confluence Data Center in a cluster there are some additional infrastructure requirements. See Clustering with Confluence Data Center for more information.

Supported platforms

See our Supported Platforms page for information on the database, Java, and operating systems you'll be able to use. These requirements are the same for Server and Data Center deployments. 

App compatibility

Apps extend what your team can do with Atlassian applications, so it's important to make sure that your team can still use their apps after migrating to Data Center. When you switch to Data Center, you'll be required to switch to the Data Center compatible version of your apps, if one is available. 

See Evaluate apps for Data Center migration for more information. 

Migrate to non-clustered Data Center

Review and upgrade your apps

If you have any apps installed on your site, you’ll need to upgrade to the Data Center app version, if one is available. To avoid any impact to your apps, we recommend you do this before you enter your Confluence Data Center license key. Learn more about Upgrading Server apps when you migrate to Data Center.

Upgrade your Confluence license

To move from Confluence Server to Confluence Data Center:

  1. Go to  > General Configuration
  2. Choose License Details from the sidebar under the Administration heading
  3. Enter your Confluence Data Center license key. 

There's no need to restart Confluence. Data Center features such as read-only mode, SAML single sign-on, and CDN will now be available. 

Set up your cluster

If your organisation requires continuous uptime, scalability, and performance under heavy load, you'll want to run Confluence Data Center in a cluster.

To find out more about clustering, including infrastructure requirements see Clustering with Confluence Data Center

If you're ready to set up your cluster now, head to Set up a Confluence Data Center cluster.  

There’s a known issue during setup where a load balancer (or proxy) pings the server and breaks Confluence installation or migration to Data Center. See CONFSERVER-61189 - Getting issue details... STATUS
During installation, you need to disable load balancer health checks and make sure you don’t open multiple tabs that point to the same Confluence URL.

Last modified on Apr 20, 2021

Was this helpful?

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