Supported platforms

Redirection notice

This page will redirect to /display/BitbucketServer/Supported+platforms .

This page lists the supported platforms for Stash 3.11.x.

See Integrating Stash with Atlassian applications for information about supported versions of JIRA.

See End of support announcements for Stash for upcoming changes to platforms supported by Stash.

See Recommendations for running Stash Server in AWS if you're running Stash on AWS

Key: (tick) = Supported  (warning) = Deprecated  (error) = Not Supported

Hardware

CPU

Evaluation: 1 core
Production: 2+ cores

  • If you are evaluating Stash, we recommend that you use a server with at least 2GB of memory.
  • 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.
  • For Amazon Web Services (AWS) instance types and sizes, see Recommendations for running Stash Server in AWS.
  • (error) Stash Data Center is not supported in AWS at this time.
  • 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 Stash for further discussion and for details of how memory is allocated for Stash and Git.
Memory 2GB+

Operating systems

Apple Mac OS X (tick) Evaluation
(error) Production
  • Stash is a pure Java application and should run on any platform, provided all the Java requirements are satisfied.

  • In production environments Stash should be run from a dedicated user account.

  • (error) Apple Mac OS X is not supported for production deployment.
  • (error) Microsoft Windows is not supported for 500+ Enterprise tiers.

Linux (tick)

Microsoft Windows

(tick) < 500 users
(error)  500+ Enterprise

Java

Oracle Java

(tick) 1.8
(warning) 1.7
(error) 1.6

  • We recommend using Oracle JRE 8, which you can download from the Oracle website.
  • For Java 8 we recommend 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.
  • (warning) 1.8.0u51 introduced improved certification checking which, due to a bug in Crowd, will prevent connection to external user directories over SSL. To workaround this issue either add the following JVM option -Djdk.tls.trustNameService=true or deselect "Secure SSL" under the  "Advanced Settings" for the external user directory definition. For more details: BSERV-7741 - Secure LDAP connections are broken when using Java 1.8u51+, 1.7.0_85+ and 1.6.0_101+ Closed
  • Stash only requires the Java JRE, not the JDK.
  • For OpenJDK, download and install instructions for Linux flavors are at http://openjdk.java.net/install/.
  • Note that the Stash installer will install a supported version of the Oracle Java JRE, which is only available to Stash, if necessary. See Running the Stash installer.
  • (error) OpenJDK >= 1.8u25 and < 1.8u40 are not supported due to a severe defect, Bug 1167153. This was fixed in 1.8u40.
  • (error) Support for Java 6 was removed in Stash 3.0, as previously announced.
  • (warning) Support for Java 7 is deprecated, and will be removed in Stash 4.0. See End of support announcements for Stash.

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 EC2 instance for more information.

OpenJDK

(tick) 1.8u0 - 1.8u20

(tick) 1.8u40+

(error) 1.8u25+
(warning) 1.7 
(error) 1.6

Databases
HSQLDB

(tick) Evaluation
(error) Stash Data Center

Microsoft SQL Server / Microsoft SQL Server Express

(tick) 2014
(tick) 2012
(tick) 2008 R2
(tick) 2008

(warning) 2005

(warning) Support for SQL Server 2005 is deprecated and will be removed in Stash 4.0.
MySQL

Stash Server:

(tick) 5.6.16+
(tick) 5.5.x
(tick) 5.1.x

(error) 5.7+
(error) 5.6.0 – 5.6.15

(tick) MariaDB 5.5
(tick) MariaDB 10.0
(error) MariaDB 10.1

(error) Stash Data Center

MySQL, while supported by Stash 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 Stash 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.

Stash 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 Stash (such as PostgreSQL, which is also freely available) than you will with MySQL.

  • MariaDB 10.1 releases are still classed as betas and are not supported
  • (error) MySQL 5.6.15 and earlier: Note that Stash 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 Stash to MySQL for more information.
  • (error) MySQL 5.7+ is not supported.

  • (error) MySQL (any version) is not supported in Stash Data Center.

Oracle

(tick) 12c
(tick) 11g

 

PostgreSQL

(tick) 9.0 - 9.4
(tick) 8.2 - 8.4

 

Web browsers

Chrome (tick) Latest stable version supported

Firefox (tick) Latest stable version supported  

Internet Explorer

(tick) 11
(warning) 10
(warning) 9
(error) 8

Safari

(tick) Latest stable version supported

 
DVCS

Git – server

The table lists the versions of Git that have been tested against the  Stash 3.11.x releases.

  • In general, we recommend using the most recent version of Git on both the Stash server and clients, where possible, and subject to the following notes and exceptions.
  • The version of Git installed on machines that interact with Stash must be compatible with the version of Git installed for use by the Stash server.
  • For Git 1.9.0 and later we only test the highest bugfix release – all earlier bugfix releases in that series are also supported, unless specifically indicated otherwise below.
  • (warning) Support for versions of Git earlier than v1.8 on the server is deprecated and will be removed in Stash 4.0. See End of support announcements for Stash.
  • (warning) Git 1.8.3.x has some performance regressions which may cause problems in Stash with large repositories.
  • (warning) Git 2.2.x - 2.4.0 have some performance issues when interacting with NFS. Hence, these versions are currently not supported for Stash Data Center or for Stash Server installations that use NFS mounts for the home directory (Details)
  • (error) Cygwin : Cygwin Git is not supported for use on Windows servers, regardless of version.
  • (error) Git 1.7.1 is not supported.
  • (error) Git 1.8.4.3 is not supported due to a critical bug in how symbolic refs are handled which breaks pushing and pulling for repositories with pull requests. (Details)
    BSERV-4101 - Clone and fetch fail with "protocol error: impossibly long line" Closed
  • (error) Git 2.0.2 and 2.0.3 are not supported due to a critical bug in git diff-tree which breaks Stash's commit page. (Details)
    BSERV-5052 - Commit messages are wrong when using Git 2.0.2 and 2.0.3 Closed

[Security vulnerability CVE-2014-9390] affects multiple Git versions. Stash itself is not affected, however end-users should update their clients to a patched maintenance version: v1.8.5.6, v1.9.5, v2.0.5, v2.1.4 and v2.2.1 or newer. For instructions see Installing and upgrading Git.

Supported Tested
Linux Windows

(warning) 2.4.0
2.4.1+

2.4.5  
(warning) 2.3.0+ 2.3.8  
(warning) 2.2.0+ 2.2.2  
2.1.0+ 2.1.4  
2.0.0–2.0.1
2.0.4+
2.0.5  
1.9.0+ 1.9.5 1.9.5.1
1.8.0–1.8.4.2       1.8.4.4+ 1.8.0.3
1.8.1.5  
1.8.2.3  
1.8.3.4  
1.8.4.5  
1.8.5.6

1.8.0
1.8.1.2  

1.8.3       1.8.4       1.8.5.2

(warning) 1.7.6+ 1.7.6.6   1.7.7.7   1.7.8.6   1.7.9.7   1.7.10.5   1.7.11.7  
1.7.12.4
1.7.6      
1.7.7.1   1.7.8      
1.7.9
1.7.10     1.7.11
Git – client (tick) 1.6.6+

[Security vulnerability CVE-2014-9390] affects multiple Git versions. Stash itself is not affected, however end-users should update their clients to a patched maintenance version: v1.8.5.6, v1.9.5, v2.0.5, v2.1.4 and v2.2.1 or newer. For instructions see Installing and upgrading Git.

Windows git client users are recommended to use Git-1.9.5-preview20150319 or higher which fixes an openssl vulnerability.


Additional tools
Perl (tick) 5.8.8+  
Mail clients
Apple Mail (tick) Apple Mail 4

Gmail (tick) Latest
iOS Devices (tick) iPhone, iPad
Microsoft Outlook (tick) Express, 2007, 2010

Outlook.com

Hotmail

Windows Live Mail

(tick) Latest

Notes:

Deploying multiple Atlassian applications in a single Tomcat container is not supported. We do not test this configuration and upgrading any of the applications (even for point releases) is likely to break it.

Finally, we do not support deploying any other applications to the same Tomcat container that runs Stash, especially if these other applications have large memory requirements or require additional libraries in Tomcat's lib subdirectory.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport