Supported platforms

Still need help?

The Atlassian Community is here for you.

Ask the community

This page lists the supported platforms for  Bitbucket Data Center and Server 7.17.x.

See End of support announcements for upcoming changes to platforms supported by Bitbucket.

Please read the supplied information carefully and check if it applies to your instance. 

(tick) Supported you can use Bitbucket Data Center and Server 7.17.x with this platform.

(info) Limited you can evaluate Bitbucket on this platform, but you can't use it to run a production site. 

(warning) Deprecated support for this platform will end in an upcoming release.

On this page:

Hardware

HardwareGood to know

Architecture

x86-64

CPU

2+ cores

Memory:

3+ GB

  • You'll need at least 3GB available memory. We recommend 1GB for Bitbucket 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. 

Environments

EnvironmentsGood to know

(tick) Linux

(tick) Microsoft Windows (up to 500 users)

(info) Apple macOS

  • In production environments Bitbucket 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+. 

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.

Containerization

You can use official images to deploy Bitbucket in a Docker container or customize a Docker deployment on your own.

We support the Atlassian Docker templates and can help with Bitbucket related problems. We don't provide support for Docker itself or problems with any Docker environment.

Containerization manager

We recommend that you use official helm charts to deploy Bitbucket Data Center with Kubernetes or customize a Kubernetes deployment on your own with the reference to the official helm charts.

We support the Atlassian Kubernetes helm chart and can help with Bitbucket Data Center product-related problems. We don't provide support for Kubernetes itself or problems with any Kubernetes environment.

Read our Kubernetes support disclaimer and more about what we support and what we don’t.

Cloud platforms

Cloud platformsGood to know

(tick) Amazon Web Services (AWS)

(tick) Microsoft Azure

See Recommendations for running Bitbucket in AWS for more information.

Known issues

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

Java

JavaGood to know

(tick) Java 11.0.8+

(warning) Java 11.0.0 through 11.0.7

(error) Java 10

(error) Java 9

(tick) Java 8 (supported from 1.8u65+)

Databases

If you’re using PostgresSQL and glibc version lower than 2.28 and upgrading your operating system libraries, you’ll need to rebuild the PostgresSQL indices before you start Bitbucket if the upgrade increases the glibc version to 2.28 or later.

PostgreSQL

(tick) 9.6 - 13

(warning) 9.5

(warning) 9.4

Known issues

Connect Bitbucket to PostgreSQL

MySQL (Bitbucket Server only)

(tick) 8.0.11+

(tick) 5.7.9+

(warning) 5.6.16+

(warning) 5.5.8+

(tick) MariaDB 10.4.6+

(tick) MariaDB 10.3.7+

(tick) MariaDB 10.2.6+

(warning) MariaDB 10.1.8+

(error) MariaDB 10.0.10 

(warning) MariaDB 5.5.23+

Known issues

MySQL, while supported by Bitbucket, 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 with the following:

Do not use MySQL in Bitbucket Data Center.

Microsoft SQL Server / Microsoft SQL Server Express

(tick) 2019

(tick) 2017

(tick) 2012 - 2016

Good to know

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

Known issues

Oracle

(tick) 19c

(tick) 18c

(tick) 12c

(warning) 11g

No additional information or known issues

Amazon Aurora (Data Center only)

(tick) PostgreSQL 9.6 - 11

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)

(info) Bitbucket Server, evaluation only

(tick)  Bitbucket Mirror

Good to know

  • H2 is bundled with Bitbucket 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

(warning) Deprecated


Good to know

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

Integrations

See Integrate with Atlassian applications for supported version combinations.

CI/CD

We recommend upgrading to the latest version of your CI server to ensure that the environment is as secure and stable as possible. See Integrated CI/CD for more information about linking Bitbucket and your CI application.

Jenkins
(tick) 2.162+

Good to know

Bamboo

(tick) 5.6 - 6.10

(tick) 7.0+ 

Good to know

Browsers

BrowsersGood to know

(tick) Chrome

(tick) Firefox

(tick) Edge

(tick) Safari 

  • We recommend using the latest stable versions of these browsers.
  • Bitbucket has a minimum supported browser resolution of 1100px.
  • Bitbucket supports the latest stable version of Chromium-based Microsoft Edge and does not support legacy Microsoft Edge (versions 18 and lower).
  • Mobile browsers are not supported.

DVCS

Git – server

(tick)  2.11.x - 2.33.x 

Good to know

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

  • The version of Git installed on machines that interact with Bitbucket must be compatible with the version of Git installed for use by the Bitbucket 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.

Git – client

(tick) 1.8.4.3+

(tick) 1.6.6+


Good to know  

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

Git LFS - client

(tick) 1.1.0+


Good to know

  • Git LFS 3.0 includes backwards incompatible changes with Bitbucket Data Center & Server 7.16.0 and below.

Internet protocols

Internet protocolGood to know

(tick) IPv4

(tick) IPv6

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

Additional tools

ToolsGood to know

Perl

(tick) 5.8.8+

Elasticsearch

(tick) 7.16.2, 7.16.3

(tick) 7.10.2

(tick) 7.9.3

(tick) 7.5.2

(tick) 6.8.6, 6.8.22, 6.8.23

(warning) 6.6.1

(warning) 6.5.3

(warning) 5.5.1, 5.5.3

OpenSSH

(tick) 7.2+

  • Perl is usually provided automatically with Git.
  • Elasticsearch 6.5.3, 6.6.1, 6.8.6, 6.8.22, 6.8.23, 7.5.2, 7.9.3, 7.10.2, 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.
Last modified on Sep 13, 2023

Was this helpful?

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