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.

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.  

Last modified on Apr 26, 2023

Was this helpful?

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