Supported platforms

Architecture

x86-64

CPU

Evaluation: 1 core 
Production: 2+ cores

Memory:

3GB+

Good to know

• You'll need at least 3GB available memory. We recommend 1GB for Bitbucket Server and an additional 2GB to support Git operations. 
• Your specific hardware requirements will depend on the number and frequency of Git operations and the number of active users. See Scaling Bitbucket Server for more information. 

 Linux

 Microsoft Windows (up to 500 users)

 Apple macOS

Known issues

• Microsoft Windows is not supported for Bitbucket Data Center, or for 500+ user tiers.
• You should not use Windows Resilient File System (ReFS) as NTFS is required.
• You can't use NFS hosted on Windows for Bitbucket's shared home directory.
• Apple macOS is evaluation only. MacOS cannot be used for production deployment.

Good to know

• In production environments Bitbucket Server should be run from a dedicated user account.
• Linux support requires a 2.6.17+ kernel and glibc 2.7+. This means that Red Hat Enterprise Linux 5, which uses glibc 2.5, is no longer supported for Bitbucket Server 7.0+. 

 Amazon Web Services (AWS)

 Microsoft Azure

Known issues

You can't use  Amazon Elastic File System (EFS)  for Bitbucket Server's shared home directory.

Good to know

See  Recommendations for running Bitbucket Server in AWS  for more information.

Oracle Java & OpenJDK

 Java 11.0.8+

 Java 11 through 11.0.7

 Java 10

 Java 9

 Java 8 (supported from 1.8u65+)

Good to know

• Bitbucket Server 8.0 will raise the minimum supported Java version to 11.0.8. Java versions 11.0.0 - 11.0.7 are not recommended due to Java bug: JDK-8241054

• Bitbucket Server will install a supported version of AdoptOpenJDK Java JRE that is only available to Bitbucket Server if necessary. See Running the Bitbucket Server installer.

• If you choose to pre-install a JRE, we recommend using AdoptOpenJDK's Java 8 JRE, which you can download from the AdoptOpenJDK website.

• For OpenJDK, download and install instructions for Linux flavors at http://openjdk.java.net/install/.

• Pre-installed Java on some AWS EC2 Linux instances might be installed with a subset of features. See SSH server fails to start on AWS EC 2 instance for more information.

• We support standard OpenJDK builds, including Oracle's official build, alternative builds such as AdoptOpenJDK, and builds shipped with Linux distributions such as Red Hat Enterprise. 

PostgreSQL

 9.5 - 12

 9.4

Known Issues

Connecting Bitbucket Server to PostgreSQL

MySQL  (Bitbucket Server only)

 8.0.11+

 5.7.9+

 5.6.16+

 5.5.8+

 MariaDB 10.4.6+

 MariaDB 10.3.7+

 MariaDB 10.2.6+

 MariaDB 10.1.8+

  MariaDB 10.0.10 

 MariaDB 5.5.23+

Known Issues

MySQL, while supported by Bitbucket Server, is currently not  recommended, especially for larger instances, due to inherent performance and deadlock issues that occur in this database engine under heavy load.

See Connecting Bitbucket Server to MySQL for more details and http://dev.mysql.com/doc/refman/5.0/en/innodb-deadlocks.html for some general information on deadlock issues.

You should not use Bitbucket Server with the following:

• MySQL 5.6.15 and earlier: due to bugs in its query optimizer (#68424, #69005). See Connecting Bitbucket Server to MySQL for more information.
• MySQL 5.7.0 - 5.7.8

Do not use MySQL in Bitbucket Data Center.

Microsoft SQL Server / Microsoft SQL Server Express

 2019

 2017

 2012 - 2016

Known Issues

• Connecting Bitbucket Server to SQL Server
• Named Instances: If you have a named instance on your server, it is not possible to migrate from the internal database to a named instance of SQL Server using the UI procedure. You will need to manually edit the bitbucket.properties file as described on the Connecting to named instances in SQL Server from Bitbucket Server Knowledge Base article.

Good to know

Using  Windows Authentication between a Linux Bitbucket Server installation and SQL sever  is not supported. 

Oracle

19c

18c

 12c

 11g

Amazon Aurora (Data Center only)

 PostgreSQL 9.6

Good to know

• The only supported Amazon Aurora config is a PostgreSQL-compatible clustered database with one writer replicating to zero or more readers. Learn more

H2 (bundled)

   Bitbucket Server, evaluation only

  Bitbucket Mirror

Good to know

• H2 is bundled with Bitbucket Server for evaluation use only.
• H2 (bundled) is the only database that is supported with Bitbucket Data Center mirrors in production.

HSQLDB (bundled)

Bitbucket Server only, evaluation only
 Deprecated

Good to know

• Please see connecting Bitbucket Server to an external database.
• HSQLDB is not supported in Bitbucket Data Center.
• HSQLDB support was deprecated as of Bitbucket Server 4.0+. New Bitbucket Server installs will bundle and use H2 as the default database for evaluation purposes.

Git – server

  2.28.x 

  2.27.x 

  2.26.x 

  2.25.x 

  2.24.x 

  2.23.x 

 2.22.x

 2.21.x

 2.20.x

 2.19.x

 2.18.x

 2.17.x

 2.16.x

 2.15.x

 2.14.x

 2.13.x

 2.12.x (except 2.12.2 on Windows)*

 2.11.x

Git – server

We recommend using the most recent supported version of Git on both the Bitbucket Server instance and clients where possible, subject to the following notes and exceptions:

• The version of Git installed on machines that interact with Bitbucket Server must be compatible with the version of Git installed for use by the Bitbucket Server instance.

• When using smart mirroring, you must have a minimum version of Git 2.11.1 installed.

• Do not use CygwinGit on Windows servers, regardless of version.

• Git for Windows 2.12.2 has a regression in git status which causes editing files to fail. The regression has been fixed, and the fix was included in Git for Windows 2.12.3.

• BSERV-9673 - File editing fails using Git for Windows 2.12.2

Git – client

 1.8.4.3+
 1.6.6+

Or where Git LFS is used 1.8.2

Git LFS - client

 1.1.0+

Git – client  

A bug was fixed in Git version 1.8.4.3 that prevented http push proxying from working. 

 Internet protocols

 IPv4

 IPv6

Good to know:

When using Bitbucket Server in IPv6 environments,  we recommend that hostnames rather than IP addresses are used .

Perl

 5.8.8+

Elasticsearch

 7.16.2, 7.16.3

 7.5.2

6.8.6, 6.8.22, 6.8.23

 6.6.1

 6.5.3

 5.5.1, 5.5.3

Good to know

• Perl is usually provided automatically with Git.
• Elasticsearch 6.5.3, 6.6.1, 6.8.22, 6.8.6, 6.8.22, 6.8.23, 7.16.2 and 7.16.3 are supported with the Buckler plugin. Learn how to secure Elasticsearch with Buckler.
• Elasticsearch 6.4 is supported with AWS.