Supported platforms details
This page lists detailed notes regarding supported platforms for Bitbucket Server 5.0.x. See Supported platforms for a list of supported platforms.
On this page
- As well as the memory allocated for Tomcat (768MB is the default configuration and suitable for most uses), additional memory and CPU capacity is required to support Git operations. We recommend that you use a server with at least 2GB of available memory.
- The hardware requirements for a full production deployment depend on the number and frequency of Git operations and the number of active users. See Scaling Bitbucket Server for further discussion and for details of how memory is allocated for Bitbucket Server and Git.
- Bitbucket Server is a pure Java application and should run on any platform, provided all the Java requirements are satisfied.
- In production environments Bitbucket Server should be run from a dedicated user account.
- Apple macOS is not supported for production deployment.
- Microsoft Windows is not supported for 500+ Enterprise tiers.
- Windows Resilient File System (ReFS) is not supported at this time, NTFS is required
- Amazon Web Services (AWS)
- Note that the Bitbucket Server installer will install a supported version of the Oracle Java JRE, which 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.
- We recommend Java 1.8.0u40+ to avoid critical defects in older versions. If you are terminating SSL at Tomcat there is a known Java bug that has been fixed in version 1.8.0u51. Alternatively, you can continue using 1.8u40+ with the addition of a JVM flag. Further details: Application crashes due to 'Internal Error (sharedRuntime.cpp:833)' caused by Java 8 bug.
- For OpenJDK, download and install instructions for Linux flavors are at http://openjdk.java.net/install/.
- OpenJDK >= 1.8u25 and < 1.8u40 are not supported due to a severe defect, Bug 1167153. This was fixed in 1.8u40.
- OpenJDK 1.8u51 and 1.8u60 have known issues working with LDAP. See CWD-4444 for details.
- Please see connecting Bitbucket Server to an external database.
- HSQLDB is not supported in Bitbucket Data Center.
- HSQLDB support is deprecated as of Bitbucket Server 4.0+. New Bitbucket Server installs will bundle and use H2 as the default database for evaluation purposes.
- H2 is bundled with Bitbucket Server and is only intended for evaluation use.
- H2 can be used with Bitbucket Data Center mirrors in production.
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.
Affected systems may experience slow response times, deadlock errors and in extreme cases errors due to running out of database connections. These issues are intrinsic to MySQL (no other database engine supported by Bitbucket Server shares this behavior) and are due to the way MySQL performs row-level locking in transactions. See http://dev.mysql.com/doc/refman/5.0/en/innodb-deadlocks.html for some general information on this.
Bitbucket Server does its best to work around the MySQL behavior - see issues STASH-4517, STASH-4701 and others, for example. But under very heavy load you will generally get better performance with any of the other database engines supported by Bitbucket Server (such as PostgreSQL, which is also freely available) than you will with MySQL.
- MariaDB 5.0 and 5.1 support is deprecated as of Bitbucket Server 5.0+.
- MySQL 5.0.x and 5.1.x support is deprecated as of Bitbucket Server 5.0+.
- MySQL 5.6.15 and earlier: Note that Bitbucket Server does not support versions of MySQL 5.6 earlier than 5.6.16 at all, because of bugs in its query optimizer (#68424, #69005). See Connecting Bitbucket Server to MySQL for more information.
- MySQL 5.7+ is not supported.
- MySQL is not supported at all in Bitbucket Data Center.
- 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.
Named Instances: If you have a named instance on your server, it
- PostgreSQL 9.3 versions prior to 9.3.6 contain a bug that is known to cause crashes. (See PostgreSQL segmentation fault after upgrading to Bitbucket 4.11 and up)
- PostgreSQL 9.1.x and earlier support is deprecated as of Bitbucket Server 5.0+.
- SQL Server 2008 and 2008 R2 support is deprecated as of Bitbucket Server 5.0+.
Git - server
In general, we recommend using the most recent version of Git on both the Bitbucket Server instance and clients, where possible, and 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.
- Cygwin Git is not supported for use on Windows servers, regardless of version.
- Git 1.8.3.x has some performance regressions which may cause problems in Bitbucket Server with large repositories.
- STASH-4101Getting issue details... STATUS
Git 126.96.36.199 is not supported due to a critical bug in how symbolic refs are handled which breaks pushing and pulling for repositories with pull requests. (
git diff-treewhich breaks Bitbucket Server's commit page. (Details)
- STASH-5052Getting issue details... STATUS
Git 2.0.2 and 2.0.3 are not supported due to a critical bug in
- Git 2.2.x - 2.4.0 have some performance issues when interacting with NFS. Hence, these versions are currently not supported for Bitbucket Data Center or for Bitbucket Server installations that use NFS mounts for the home directory.
blamefrom the interface.
- BSERV-9570Getting issue details... STATUS
Git 2.11.1 is known to cause an error when trying to use
- 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 will be included in Git for Windows 2.12.3, when that is released.
- BSERV-9673Getting issue details... STATUS
- Git 2.2.x - 2.8.x If using mixed line modes, it is recommended to use a version greater than or equal to 2.9.4 as mixed line modes can cause issues with merging and creating pull requests.
maintenance version: 2.4.11, 2.5.5, 2.6.6 or 2.7.4 or newer. For instructions see Installing and upgrading Git.[Security vulnerability CVE-2016-2324 & CVE-2016-2315] affects multiple Git versions. Both server and client Git installations should be updated to a patched
The table below lists the versions of Git that have been specifically tested against the Bitbucket Server 5.0.xreleases.
Git - client
[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.