Migrate from Server to 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:

License

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 my.atlassian.com

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. 

Requirements

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

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

  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 Oct 27, 2022

Was this helpful?

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