Bitbucket Support

This page lists the supported platforms for Bitbucket Data Center 9.4.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.

Supported – you can use Bitbucket Data Center 9.4.x with this platform.

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

Deprecated – support for this platform will end in an upcoming release.

On this page:

Hardware

Hardware

Good 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 Data Center for more information.
For setting up Bitbucket Mesh, see requirements for Mesh nodes.

Environments

Environments

Good to know

Linux

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+. Any Linux platform that meets these requirements is supported. For example, Red Hat Enterprise Linux 8 and 9, Ubuntu LTS, and AWS Linux.
If you've migrated all Git repositories from the Bitbucket shared home directory to Bitbucket Mesh, you can use the following file system options for the shared home directory: NFSv3 and NFSv4 (dedicated Linux server).

Known issues

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 platforms

Good to know

Amazon Web Services (AWS)

Microsoft Azure

See Recommendations for running Bitbucket in AWS for more information.

If you've migrated all Git repositories from Bitbucket's shared home directory to Bitbucket Mesh, you can use the following file system options for the shared home directory:

NFSv3, NFSv4 (dedicated Linux server)
Amazon Elastic File System (EFS)
Amazon FSx for NetApp ONTAP NFS
Amazon FSx for OpenZFS
Amazon FSx for Lustre

Java

Java

Good to know

Java 21

Java 17

Due to an Oracle Java bug that causes Git SSH operations to fail, we support only Oracle Java 17.0.10 (in which the bug was fixed) and later. Oracle Java 17.0.0-17.0.9 aren't supported. OpenJDK Java versions aren't affected. Learn more about the Oracle Java bug
Bitbucket will install a supported version of OpenJDK Java JRE that is only available to Bitbucket if necessary. See Running the Bitbucket installer.
If you choose to pre-install a JRE, we recommend using an OpenJDK Java 17 JRE. You can download one from the Eclipse Temurin™ 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. For more information, see SSH server fails to start on AWS EC2 instance.
We support standard OpenJDK builds, including Oracle's official build, alternative builds such as Adoptium OpenJDK (formerly known as AdoptOpenJDK), and builds shipped with Linux distributions such as Red Hat Enterprise.
AdoptOpenJDK is now known as AdoptiumOpenJDK.

Databases

PostgreSQL
17 15 - 16	If you’re using PostgreSQL and glibc version lower than 2.28 and upgrading your operating system libraries, you’ll need to rebuild the PostgreSQL indices before you start Bitbucket if the upgrade increases the glibc version to 2.28 or later. Known issues Connect Bitbucket to PostgreSQL
Microsoft SQL Server
2022 2019 2017	Good to know Using Windows Authentication between a Linux Bitbucket installation and SQL sever is not supported. Known issues Connect Bitbucket 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.
Microsoft Azure
Azure PostgreSQL Flexible Server - One primary node only	No additional information or known issues
Oracle
23ai 19c	No additional information or known issues
Amazon Aurora
PostgreSQL 15 - 16	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 Data Center, evaluation only 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 Data Center only, evaluation only 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.

Secret managers

We provide a few secrets management options, as well as to our basic and advanced encryption options and our custom SecretStore implementation.

AWS Secrets Manager

Plaintext

Structured secret

Good to know

See our guide, Configuring Bitbucket with AWS Secrets Manager, for full details on how to integrate AWS Secrets Manager.

HashiCorp Vault

KV V2 Secrets Engine

Good to know

KV Secrets Engine V2 is the only version that can be used.
Authenticate with tokens and Kubernetes Service Account Tokens.
See our guide, Configure Bitbucket with HashiCorp Vault, for full details on how to integrate HashiCorp Vault.

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. Bitbucket Data Center is a Git server solution, so it works with any client that works with Git.

Jenkins

2.162+

Good to know

Integrating requires the Bitbucket Integration plugin for Jenkins.
To access the full set of Integrated CI/CD features you need to set up an Application Link.
Using an earlier version of Jenkins is possible, but its integration with Bitbucket will be minimal.
Before upgrading see the Jenkins upgrade guide on Jenkins.io.

Bamboo

5.6 - 6.10

7.0+

Good to know

Bamboo 7.0+ is required to enable Integrated CI/CD features. To access all Integrated CI/CD features you need to set up an Application Link.
Using Bamboo 5.6 to 6.10 is possible, but its integration with Bitbucket will be minimal.
Before upgrading, see the Bamboo upgrade guide.

Browsers

Browsers

Good to know

Chrome

Firefox

Edge

Safari

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
2.47.x 2.46.x 2.34.x - 2.42.x (We don't recommend Git 2.43.x, 2.44.x, and 2.45.x due to a possible performance regression.)	Due to Git's clone protection feature, which prevents Bitbucket repositories from getting forked, we don't recommend using the following Git versions so that you can avoid inconveniences or errors: 2.39.4, 2.40.2, 2.41.1, 2.42.2, 2.43.4, 2.44.1, and 2.45.1. 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.
Git – client
1.8.4.3+	Good to know A bug was fixed in Git version 1.8.4.3 that prevented http push proxying from working.
Git LFS – client
3.0.0+ 2.0.0+ 1.1.0+	Good to know Git LFS 3.0 includes backwards incompatible changes with Bitbucket Data Center and Server 7.16.0 and below.

Internet protocols

Internet protocols

Good to know

IPv4

IPv6

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

Search

Search servers

Good to know

OpenSearch

2.14

2.11

Amazon OpenSearch Service

OpenSearch 2.11

OpenSearch can be secured with OpenSearch’s security plugin. Learn how to secure OpenSearch

Additional tools

Tools

Good to know

Perl

5.8.8+

OpenSSH

7.2+

Perl is usually provided automatically with Git.

Bitbucket Support

Knowledge base

Products

Jira Software

Jira Service Management

Jira Work Management

Confluence

Bitbucket

Resources

Documentation

Community

Suggestions and bugs

Marketplace

Billing and licensing

Supported platforms

Install or upgrade Bitbucket

On this page

In this section

Still need help?

Hardware

Environments

Containerization

Containerization manager

Cloud platforms

Java

Databases

Secret managers

Integrations

CI/CD

Browsers

DVCS

Internet protocols

Search

Additional tools

In this section

Page

Viewport

Confluence

Versions

Supported platforms

Install or upgrade Bitbucket

On this page

In this section

Related content

Still need help?

Hardware

Environments

Containerization

Containerization manager

Cloud platforms

Java

Databases

Secret managers

Integrations

CI/CD

Browsers

DVCS

Internet protocols

Search

Additional tools

In this section

Related content