Supported platforms

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

Architecture

CPU

Memory:

• 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.
• For setting up Bitbucket Mesh, see requirements for Mesh nodes.

Environments

• 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.

Cloud platforms

Amazon Web Services (AWS)

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 11 (supported from 11.0.8+)

Oracle Java 8u321

Oracle Java 8u311

Java 8 (supported from 1.8u65+)

• 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 11 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.
• Oracle Java 8u311 and 8u321 are not supported due to JDK-8279618.

Databases

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