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.
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.
Install Bitbucket Server on a single node
It’s the same as a Server installation:
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.
Was this helpful?Yes Provide feedback about this article