Bitbucket installation guide
Before you start
Before installing Bitbucket Data Center and Server, check that you meet the minimum system requirements by reading the page Supported platforms.
As announced, Bitbucket 7.21 is the last release that supports Bitbucket hosting on Windows. Learn more about how to migrate from Windows to Linux
Choose your installation method
There are a number of ways to install Bitbucket. Choose the method that is best for your environment.
Install method | Is this right for you? |
|---|---|
Install a Bitbucket trial | This is the fastest way to get Bitbucket up and running. If you're evaluating Bitbucket, use this option. You don't need an external database to install a Bitbucket trial. |
Install Bitbucket Server using an installer | This option uses an installer and is the most straightforward way to get your production site up and running on a Linux server. |
Install Bitbucket Server from a zip or archive file | This option requires you to manually install files and configure some system properties. It gives you the most control over the install process. Use this option if there isn't an installer for your operating system. |
Run Bitbucket in a Docker container | This option gets Bitbucket up and running in no time using a preconfigured Docker image. Atlassian supports running Bitbucket in a Docker container, but we cannot offer support for problems that are related to the environment itself. |
Run Bitbucket in AWS | Running Bitbucket on Amazon Web Services (AWS) gives you scalable computing capacity without the need to invest in hardware up front while retaining control over where and how your code is hosted within your organization. |
You don’t need high availability or disaster recovery but could use features that are exclusive to Data Center. Deploying Data Center on a single node is the same as installing Bitbucket Server, just with a different license, which unlocks new features. Learn more at Running Bitbucket Data Center on a single node. | |
Install Bitbucket in a cluster | Bitbucket Data Center with a cluster of nodes is designed for enterprises with large or mission-critical deployments that require continuous uptime, instant scalability, and performance under high load. It can be hosted on your own infrastructure or deployed to AWS or Azure. Learn more at Clustering with Bitbucket |
Note: We do not support installing Bitbucket as a production system on macOS. A macOS download is available for the purposes of evaluating Bitbucket only. There are no limitations to using Bitbucket on a Mac with any one of the supported browsers.