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 trialThis 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 installerThis 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 fileThis 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 AWSRunning 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.  

Last modified on Jul 25, 2022

Was this helpful?

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