Supported platforms
This page lists the supported platforms for Bitbucket Data Center and Server 8.10.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.
Definitions
Supported - you can use Bitbucket Data Center and Server 8.10.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
Environments
Linux
Apple macOS
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.
Good to know
- 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+.
Cloud Platforms
Amazon Web Services (AWS)
Microsoft Azure
Known issues
You can't use Amazon Elastic File System (EFS) for Bitbucket's shared home directory.
Good to know
See Recommendations for running Bitbucket in AWS for more information.
Java
Oracle Java & OpenJDK
Java 17
Java 11 (supported from 11.0.8+)
Java 10
Java 9
Oracle Java 8u321
Oracle Java 8u311
Java 8 (supported from 1.8u65+)
Good to know
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.
PostgreSQL
10 - 15
Known Issues
MySQL (Bitbucket Server only)
8.0.11+
5.7.9+
MariaDB 10.9
MariaDB 10.8
MariaDB 10.7.3+
MariaDB 10.6.3+
MariaDB 10.5.4+
MariaDB 10.4.6+
MariaDB 10.3.7+
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:
- 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
2016
2014
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.propertiesfile 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 installation and SQL sever is not supported.
Oracle
19c
18c
12c R2
Amazon Aurora (Data Center only)
PostgreSQL 10 - 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)
Bitbucket Server, 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 Server 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.
Integrations
See Integrate with Atlassian applications for supported version combinations.
CI server
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.
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.
Jenkins
2.162+
Good to know
Integrating requires the Bitbucket Server 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.
Browsers
Desktop browsers
Chrome (latest stable version)
Firefox (latest stable version)
MS Edge (latest stable version)
Safari (latest stable version)
Good to know
- 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.40.x
2.39.x
2.38.x
2.37.x
2.36.x
2.35.x
2.34.x
2.33.x
2.32.x
2.31.x
Git – server
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+ 1.6.6+
Or where Git LFS is used 1.8.2
Git LFS - client
3.0.0+ 2.0.0+ 1.1.0+
Git – client
- A bug was fixed in Git version 1.8.4.3 that prevented http push proxying from working.
- Git LFS 3.0 includes backwards incompatible changes with Bitbucket Data Center & Server 7.16.0 and below.
IPv4
IPv6
Good to know:
When using Bitbucket in IPv6 environments, we recommend that hostnames rather than IP addresses are used .
Search
Elasticsearch
7.17.6
7.16.2, 7.16.3
7.10.2
OpenSearch
1.3
1.2
Amazon OpenSearch Service
OpenSearch 1.3
OpenSearch 1.2
OpenSearch 1.1
Elasticsearch 7.10
Good to know
The Buckler plugin can be used to secure Elasticsearch 7.10.2, 7.16.2, 7.16.3 and 7.17.6. Learn how to secure Elasticsearch with Buckler. Elasticsearch can also be secured with Elastic’s Shield plugin.
OpenSearch can be secured with OpenSearch’s security plugin. Learn how to secure OpenSearch.
Amazon OpenSearch Service is the successor to Amazon Elasticsearch Service.
Additional tools
Perl
5.8.8+
OpenSSH
7.2+
Good to know
- Perl is usually provided automatically with Git.