Supported platforms

Oracle JRE / JDK

1.6
1.7

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, we recommend that you 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.

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.x
MySQL Community Server 5.x

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.0, version must be 5.0.21 or later
• For 5.1, version must be 5.1.10 or later
• For 5.6, version must be 5.6.11 or later
• As of FishEye 3.2, support for MySQL 5.0 is deprecated, and will be removed in FishEye 3.3. See End of Support Announcements for FishEye.

 For PostgreSQL:

As of FishEye 3.2, support for PostgreSQL 8.2 is deprecated, and will be removed in FishEye 3.3. See End of Support Announcements for FishEye.

 For SQL Server:

As of FishEye 3.2, support for SQL Server 2005 is deprecated, and will be removed in FishEye 3.3. See End of Support Announcements for FishEye.

PostgreSQL

8.2, 8.3, 8.4

Oracle

11g

SQL Server

2005, 2008, 2008 R2, 2012

HSQLDB

Bundled; for evaluation use only

Microsoft Internet Explorer

8.0, 9.0, 10.0
6.0 and 7.0 are not supported

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

Client:
 SVNKit (bundled & the default)
 Native JavaHL 1.7
  Native JavaHL 1.6

FishEye 3.1, and later, supports SVN 1.7.x with the native JavaHL 1.7 client.

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

See Native support for SVN 1.7 for discussion.

Subversion 1.8 support is currently being assessed. FishEye does not yet work for file:// access to repositories created with Subversion 1.8 when using the bundled SVNKit client.

CVS (and CVSNT)

All versions

Perforce

Client version 2007.3 or later

Git

1.7.1.1 or later

Externally-hosted repositories only are supported.

Mercurial

1.5.1, 1.5.4, 1.6.4, 1.7.5, 1.8.4, 1.9.3

2.0.2, 2.1.2, 2.2.3, 2.3.2, 2.4, 2.5.2

2.6.x and higher

Mercurial 2.1 has a bug that makes it incompatible with FishEye. Please use Mercurial 2.1.1 or later. Mercurial 2.6.x is currently not compatible.

You should restart FishEye after upgrading Mercurial.

Crowd server 2.4.x

Crowd client library: 2.4.1

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.