Moving to Bitbucket Data Center

Install Bitbucket Data Center

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

This page outlines the process for migrating an existing Bitbucket Server instance to Bitbucket Data Center.

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

Before you begin

Things you should know about when setting up your Data Center:


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

You can purchase a Data Center license or create an evaluation license at

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. 


To use Bitbucket Data Center, you must:

To run Bitbucket in a cluster, you’ll need to meet additional requirements, like setting up a shared home directory or load balancer. You can learn more about it after going to ‘Set up your cluster’.

Move from Bitbucket Server to Data Center

To move from Bitbucket Server to Bitbucket Data Center:

  1. Go to Administration > Licensing.

  2. Enter your Bitbucket Data Center license key. 

There's no need to restart Bitbucket. Data Center features such as rate limiting and SAML single sign-on will now be available.

Set up your cluster

If your organization requires continuous uptime, scalability, and performance under heavy load, you’ll want to run Bitbucket Data Center in a cluster.

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

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

Last modified on Mar 2, 2020

Was this helpful?

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