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.
To use Confluence Data Center you must:
- Have a Data Center license (you can purchase a Data Center license or create an evaluation license at my.atlassian.com)
- Use a supported external database, operating system and Java version
- Use OAuth authentication if you have application links to other Atlassian products (such as Jira)
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.
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.
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:
- Go to > General Configuration
- Choose License Details from the sidebar under the Administration heading
- 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-61189Getting issue details...
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.