Supported platforms
This page lists the supported platforms for Bitbucket Server 6.2.x.
See End of support announcements for Bitbucket Server for upcoming changes to platforms supported by Bitbucket Server and Bitbucket Data Center.
Please read the supplied information carefully and check if it applies to your instance.
Definitions
Supported - you can use Bitbucket Server 6.2.x with this platform.
Limited - you can evaluate Bitbucket Server 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
Microsoft Windows (up to 500 users)
Apple macOS
Known issues
- Microsoft Windows is not supported for Bitbucket Data Center / 500+ Enterprise tiers.
- You should not use Windows Resilient File System (ReFS) as NTFS is required.
- 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.
Cloud Platforms
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.
Java
Oracle Java & OpenJDK
Java 11
Java 10
Java 9
Java 8 (supported from 1.8u65+)
Good to know
Bitbucket Server will install a supported version of Oracle 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 Oracle JRE 8, which you can download from the Oracle 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.
Databases
PostgreSQL
9.4 - 11
Known Issues
MySQL (Bitbucket Server only)
8.0.11+
5.7.9+
5.6.16+
5.5.8+
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
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.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 Server installation and SQL sever is not supported.
Oracle
12c
11g
H2 (bundled)
Bitbucket Server, evaluation only
Bitbucket Mirror
Good to know
- H2 is bundled with Bitbucket Server for evaluation use only.
- H2 can be used 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.
Integrations
See Integrating Bitbucket Server with Atlassian applications for supported version combinations.
Web browsers
Chrome
Latest stable version supported
Firefox
Latest stable version supported
MS Edge
Latest stable version supported
Internet Explorer
11
Safari
Latest stable version supported
DVCS
Git – server
2.21+
2.20+
2.19+
2.18+
2.17+
2.16+
2.15+
2.14+
2.13+
2.12+ (except 2.12.2 on Windows)*
2.11+
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.
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
The table below lists Git versions specifically tested against Bitbucket Server 6.0 releases.
The table below lists the versions of Git that have been specifically tested against the releases.
Linux | Windows |
|---|---|
| 2.21.0 2.20.1 2.19.2 2.18.1 2.17.2 2.16.5 2.15.3 2.14.5 2.13.7 2.12.5 2.11.4 | 2.21.0 2.20.1 2.19.2 2.18.0 2.17.1 2.16.3 2.15.1 2.14.3 2.13.1 2.12.1 2.11.1 |
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.
[Security vulnerability CVE-2016-2324 & CVE-2016-2315] affects multiple Git versions. Both server and client Git installations should be updated to a patched maintenance version: 2.4.11, 2.5.5, 2.6.6 or 2.7.4 or newer. For instructions see Installing and upgrading Git.
IPv4
IPv6
Good to know:
- When using Bitbucket Server in IPv6 environments, we recommend that hostnames rather than IP addresses are used.
Additional tools
Perl
5.8.8+
Elasticsearch
6.5.3
5.5.1 - 5.5.3
Good to know
- Perl is usually provided automatically with Git
- Elasticsearch 5.5.1, 5.5.3 and 6.5.3 are supported with Buckler
- Elasticsearch 6.4 is supported with AWS
Mail clients
Apple mail
Apple Mail 4
Gmail
Latest
iOS devices
iPhone, iPad
Microsoft Outlook
Express, 2007, 2010
Outlook.com
Latest
Hotmail
Latest
Windows Live Mail
Latest