Bitbucket Server installation guide
Before you start
Before installing Bitbucket 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 Server. 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 Windows or 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 Server in a Docker container | This option gets Bitbucket Server up and running in no time using a preconfigured Docker image. Atlassian supports running Bitbucket Server in a Docker container, but we cannot offer support for problems which are related to the environment itself. |
| Run Bitbucket Server or Data Center 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 organisation. |
Install Bitbucket 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 | Jira 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 Data Center |
Note: we do not support installing Bitbucket Server as a production system on macOS. A macOS download is available for the purposes of evaluating Bitbucket Server only. There are no limitations to using Bitbucket Server on a Mac with any one of the supported browsers.