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.
See our Supported platforms page for information on the database, Java, and operating systems you'll be able to use.
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:
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 Confluence)
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:
Go to Administration > Licensing.
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 Data Center.
If you’re ready to set up your cluster now, head to Set up a Bitbucket Data Center cluster.
Looking to migrate all your Atlassian applications to Data Center? We’ve got you covered:
- Upgrade from Bitbucket Server to Bitbucket Data Center
- Migrate to Crowd Data Center
- Migrate to Confluence Data Center
- Migrate to Jira Data Center
Considering moving to cloud? Plan your cloud migration.
Was this helpful?Yes Provide feedback about this article