Supported platforms

Oracle JRE / JDK

1.8
1.7
1.6 (deprecated)

FishEye 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 http://openjdk.java.net/install/.

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 Java, you must set the JAVA_HOME environment variable. See Installing FishEye on Windows or Installing FishEye on Linux and Mac.
• 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.
• If you intend to run FishEye as a Windows Service, using the Java Service Wrapper, you should use the Java JDK rather than the JRE so as to take advantage of the -server parameter.
• You'll need the JDK for the JSP source download.

Note also that a bug in Java 1.6.0_29 and above will prevent a connection to an external SQL Server 2008 database without an additional workaround.

Avoid using versions between 1.6.0_17 and 1.6.0_21 due to known performance issues.

Please refer to End of Support Announcements for further information on the deprecation of JDK 1.6

Microsoft Windows

• FishEye is a pure Java application and should run on any platform provided the requirements for the JRE or JDK are satisfied.
• Although FishEye 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 choose to run FishEye in a VM, please ensure that you choose a VM with good IO throughput.

Linux

Apple Mac OS X

MySQL

MySQL Enterprise Server 5.1+
MySQL Community Server 5.1+

MySQL 5.0

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

External databases (such as MySQL) are generally more resistant to data loss during a system crash.

See the FishEye Database documentation for further details.

For MySQL:

• For 5.1, the version must be 5.1.10 or later
• For 5.6, the version must be 5.6.11 or later
• FishEye 3.3+ no longer supports MySQL 5.0. See End of Support Announcements for FishEye.

 For PostgreSQL:

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

 For SQL Server:

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

PostgreSQL

9.0, 9.1, 9.2, 9.3

8.3, 8.4

8.2

Oracle

11g

SQL Server

2008, 2008 R2, 2012

2005

HSQLDB

Bundled; for evaluation use only

Microsoft Internet Explorer

9.0, 10.0, 11.0
8.0

Mozilla Firefox

Latest stable version supported
3.6, 4.0

Safari

Latest stable version supported
4, 5

Chrome

Latest stable version supported

Subversion

Server:
 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 1.8

Client:
 SVNKit (bundled & the default)

Native JavaHL 1.8
 Native JavaHL 1.7
  Native JavaHL 1.6

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

See Native support for SVN for discussion.

CVS (and CVSNT)

All versions

Perforce

Client version 2007.3 or later

Git

1.9.2

1.8.0.3, 1.8.1.5, 1.8.3.1, 1.8.3.2, 1.8.4.5, 1.8.5.2, 1.8.5.5

1.7.1.1, 1.7.2.5, 1.7.3.5, 1.7.4.5, 1.7.5.4, 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

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

Git 1.8.4.3 is not supported. See STASH-4101 - Getting issue details... STATUS

Externally-hosted repositories only are supported.

Mercurial

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

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 FishEye against.

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

You should restart FishEye after upgrading Mercurial.

Crowd server 2.4.x

Crowd client library: 2.4.1

FishEye to JIRA communication requires JIRA 5.0.x or later. Communication the other way, from JIRA to FishEye, depends on the JIRA FishEye Plugin.

Note that the JIRA FishEye Plugin is bundled with JIRA. If you are using a version of JIRA earlier than JIRA 5.0 you can upgrade the plugin in JIRA to get support for FishEye.

CPU

1.8GHz or higher, a single core is sufficient. More cores or higher GHz will result in better load-handling ability.

RAM

1GB minimum, 2GB will provide performance "headroom". Your Java heap should be sized at 512MB with the FISHEYE_OPTS environment variable, adjustable up to 1024MB depending on performance.

I/O

FishEye's input/output is an important element of its overall performance. If FishEye accesses your repository remotely, make sure that the throughput is maximum and the latency minimum (ideally the servers are located in the same LAN, running at 100Mbps or faster).

Subversion

14386

466 MB in 12151 files

647 MB

CVS

8210

115 MB in 11433 files

220 MB

Subversion (server)

FishEye can communicate with any repository running Subversion 1.1 or later.

Subversion (client)

FishEye now bundles the SVNkit client, which becomes the default Subversion interface. An alternative is to use the native subversion client, using JavaHL bindings. Please see Subversion Client Setup for more information.

Perforce (client)

FishEye needs access to the p4 client executable. Due to some problems with earlier versions of the client, we recommend version 2007.3 or later.

CVS

If you are using CVS, FishEye needs read-access to your CVS repository via the file system. It does not support protocols such as pserver at the moment.