This page shows the supported platforms for FishEye 2.5.x and its minor releases.
Key: = Supported; = Not Supported
Oracle or Apple JRE / JDK (1)
1.5 or 1.6
Microsoft Windows (2)
Apple Mac OS X (2)
MySQL Enterprise Server 5.0.21 or later
8.0 or later
(bundled; for evaluation use only)
Microsoft Internet Explorer
7.0 or later, IE6 is not supported
3 or later
4 or later
Version Control Systems
Server 1.1 or later
CVS (and CVSNT)
Client version 2007.3 or later.
1.6 or later
1.5.1 or later (Python 2.4.3 or later)
2003.06.10 or later
Supported Platform Notes
1. FishEye requires Java Runtime (JDK or JRE) version 1.5 or later (Solaris requires 1.5.0_15 as a minimum). Pre-release/Early access versions of the Java Runtime are not supported.
You can download a Java Runtime for Windows/Linux/Solaris. On Mac OS X, the JDK is bundled with the operating system. Note: It is highly recommended that you use the Oracle JVM (or use the default Mac OS X JVM), as other implementations have not been tested.
Once you have installed the JDK, you need to set the JAVA_HOME environment variable.
If 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.
2. FishEye is a pure Java application and should run on any platform provided the requirements for the JRE or JDK are satisfied.
3. The FishEye built-in database, running HSQLDB is somewhat susceptible to data loss during system crashes. External databases are generally more resistant to data loss during a system crash.
At this time, FishEye supports the following external databases:
- MySQL Enterprise Server 5.0.21 onwards and MySQL Community Server 5.0.21 onwards (see the FishEye Database documentation).
- PostgreSQL 8.x onwards (see the FishEye Database documentation).
- Oracle 11g onwards (see the FishEye Database documentation).
FishEye should ideally run on a standalone dedicated server. The most important aspect for a large-repository deployment will be I/O speed. You definitely want a fast local HDD for FishEye's cache (not NFS or SAN).
1.8GHz or higher, a single core is sufficient. More cores or higher GHz will result in better load-handling ability.
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.
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).
Disk Space Requirement Estimates
Disk space requirements for FishEye may vary due to a number of variables such as the repository implementation, file sizes, content types, the size of diffs and comments being stored. The following table contains some real-world examples of FishEye disk space consumption.
Codebase Size (HEAD of trunk)
FishEye Index Size
466 MB in 12151 files
115 MB in 11433 files
These disk space estimates are to be used as a guideline only. We recommend you monitor the disk space that your FishEye instance uses over time, as needs for your specific environment may vary. It may be necessary to allocate more space than indicated here. Additionally, you can reduce disk space consumption by turning off diff storage in FishEye.
Deployment Notes for Version Control Systems
FishEye can communicate with any repository running Subversion 1.1 or later.
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.
FishEye needs access to the
If you are using CVS, FishEye needs read-access to your CVS repository via the file system. It does not support protocols such as
Support for other version control systems is planned for future releases. Let us know what SCM system you would like to see supported by creating a JIRA issue or adding your vote to an issue, if the request already exists.
FishEye/Crucible is currently a standalone Java program. It cannot be deployed to web application servers such as WebSphere, Weblogic or Tomcat.