Upgrade from Bitbucket Server to Bitbucket Data Center

If you're a current Bitbucket Server customer looking to upgrade to Bitbucket Data Center, this page will help you create a free trial license and set up Data Center. There are several ways to get started with Bitbucket Data Center, depending on your current setup.

If you’re installing Bitbucket Data Center for the first time with no existing Bitbucket Server data to migrate, check out how to install Bitbucket Data Center.

Set up Data Center

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.

To upgrade from Bitbucket Server to Bitbucket Data Center, you will need a Data Center license. You can either purchase a full Data Center license or get a free trial license for 30 days. When your 30-day trial finishes, you’ll have the option to purchase a Data Center license and carry on using Bitbucket Data Center without losing any data you’ve created during the trial. If you decide Bitbucket Data Center is not for you, you can easily revert to your existing Server license.

Note that as of February 15, 2024 PT, your Server products will reach the end of support

Supported platforms

See our Supported platforms page for information on the database, Java, and operating systems you'll be able to use.

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’.

Upgrade to 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 Bitbucket Data Center license key. Learn more about upgrading Server apps when you migrate to Data Center.

Upgrade your Bitbucket license

To upgrade from Bitbucket Server to Bitbucket Data Center:

  1. Go to Administration > Licensing.

  2. Enter your Bitbucket Data Center license key. 

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.

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

Last modified on Nov 24, 2022

Was this helpful?

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