This is the documentation for Crucible 3.4. View the latest version of

Unknown macro: {spacejump}

or visit the latest Crucible documentation home page.

This page lists the supported platforms for Crucible 3.4.x and its minor releases.

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

Java Version



Oracle JRE / JDK

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

(error) Java 8 is not yet supported.

Crucible requires the Java Runtime (JDK or JRE), version as noted. Pre-release/Early access versions of the Java Runtime are not supported.

You can download an Oracle Java Runtime for Windows/Linux/Solaris. On Mac OS X, the JDK is bundled with the operating system.

For the OpenJDK, download and install instructions for Linux flavours are at

We highly recommend that you use the Oracle JVM or OpenJDK (for Linux only), or use the default Mac OS X JVM. Other implementations have not been tested.

Please note:

  • Once you have installed the JDK, you need to set the JAVA_HOME environment variable. See Installing Crucible on Windows or Installing Crucible on Linux and Mac for details.
  • If you are using a 64-bit JVM, please ensure that you've set your max heap size (--Xmx) to a reasonable value, considering the RAM requirements of your system. 
OpenJDK(tick) 1.7 (Linux only)
Operating Systems



Microsoft Windows


  • Crucible is a pure Java application and should run on any platform provided the requirements for the JRE or JDK are satisfied.
  • (warning) Although Crucible can be run in virtualised environments, Atlassian is not yet able to provide technical support for performance-related problems in a virtualised environment. If you do chose to run Crucible in a VM, please ensure that you choose a VM with good IO throughput.
  • (warning) On OS X Java 7 performs significantly better than Java 6



Apple Mac OS X






(tick) MySQL Enterprise Server 5.1+
(tick) MySQL Community Server 5.1+

(error) MySQL 5.0

Crucible supports a number of external databases, as listed. See the Crucible Database documentation for further details.

(warning) For MySQL:

(warning) For PostgreSQL:

Crucible 3.3+ no longer supports PostgreSQL 8.2. See End of Support Announcements for Crucible.

(warning) For SQL Server:

Crucible 3.3+ no longer supports SQL Server 2005. See End of Support Announcements for Crucible.


(tick) 9.0, 9.1, 9.2, 9.3

(tick) 8.3, 8.4

(error) 8.2


(tick) 11g

SQL Server

(tick) 2008, 2008 R2, 2012

(error) 2005


(tick) Bundled; for evaluation use only

The Crucible built-in database, running HSQLDB, is somewhat susceptible to data loss during system crashes.

We recommend that you do not use HSQLDB for production systems.

External databases are generally more resistant to data loss during a system crash and are more suited for production use.

Web Browsers



Microsoft Internet Explorer

(tick) 9.0, 10.0, 11.0
(error) 8.0

Minimum screen resolution of 1024x768. Recommended screen resolution of 1280x768 or above.

(warning) Crucible 3.3+ no longer supports Internet Explorer 8. See End of Support Announcements for Crucible.


Mozilla Firefox

(tick) Latest stable version supported
(tick) 3.6, 4.0


(tick) Latest stable version supported
(tick) 4, 5


(tick) Latest stable version supported

Version Control Systems



Subversion (SVN)

(tick)  1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 1.8

(tick)  SVNKit (bundled & the default)

(tick) Native JavaHL 1.8
(tick)  Native JavaHL 1.7
(error)  Native JavaHL 1.6

(error) FishEye 3.1, and later, do not support the native JavaHL 1.6 client.

See Native support for SVN for discussion.

(and CVSNT)

(tick) All versions


Perforce (P4)

(tick) Client version 2007.3 or later
(tick) Server version 2005.1 or later

The Server must support the ztag tagged protocol.

(error) Perforce Streams, introduced in 2011.1, is not currently supported. See FE-3886 - Getting issue details... STATUS


(tick) 1.9.2



These are the versions of Git that we currently test Crucible against.

(error) Git is not supported. See STASH-4101 - Getting issue details... STATUS

Mercurial (Hg)

(tick) 2.0.2, 2.1.2, 2.2.3, 2.3.2, 2.4, 2.5.2, 2.6.3, 2.7.2, 2.8.2, 2.9.1

(tick) 1.5.1, 1.5.4, 1.6.4, 1.7.5, 1.8.4, 1.9.3

These are the versions of Mecurial that we currently test Crucible against.

Mercurial 2.1 has a bug that makes it incompatible with Crucible. Please use Mercurial 2.1.1 or later.

You should restart Crucible after upgrading Mercurial.

Atlassian applications  

(tick) Crowd server 2.4.x

(tick) Crowd client library: 2.4.1

From version 2.8.x, Crucible bundles the Crowd 2.4.1 client library, and supports the Crowd 2.4.x server.
JIRA(tick) JIRA FishEye Plugin 6.1.0+The JIRA FishEye Plugin is bundled with JIRA. If you are using earlier versions of JIRA you can upgrade the plugin in JIRA to get support for Crucible.

Deployment Notes for Source Code Repositories

Crucible can also store uploaded files in its own database, removing the need for any kind of repository. A number of external databases are supported when Crucible is used with FishEye. See the FishEye Supported Platforms.