Migrate from Server to Data Center
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.
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.
To use Bitbucket Data Center, you must:
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’.
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 Bitbucket Data Center license key. Learn more about Upgrading server apps when you migrate to Data Center.
Upgrade your Bitbucket license
Go to Administration > Licensing.
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.
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.