This documentation relates to an earlier version of FishEye.
View this page in the current documentation or visit the current documentation home.

Skip to end of metadata
Go to start of metadata

This guide describes the advanced FishEye installation options.


Evaluating FishEye for the first time? See the FishEye 101 page.

  1. Download the FishEye zip file and extract it to a folder on your local computer.
    (warning) Folder names in the path to your FishEye executable should have no spaces in them.
    (info) The directory where you have extracted FishEye is referred as /FISHEYE_HOME/ below.
  2. Ensure you have installed an appropriate Java runtime - see Supported Platforms.
  3. Ensure that java is in the PATH, or that the JAVA_HOME environment variable is set.
  4. Go to /FISHEYE_HOME/ and run bin/ if you are on Linux/MacOS and bin\run.bat on Windows
  5. Wait for a few seconds for FishEye to start
  6. Open your browser at http://localhost:8060/ (or type the http://hostname:8060/ of the machine where you extracted FishEye).
  7. Enter your license, then the admin password to finish the setup
  8. If you intend to use FishEye with Subversion, please ensure you read the Supported Platforms, Subversion client setup, and granting permission to FishEye to scan your repository.
  9. If you intend to use FishEye with Perforce, please ensure you read the Perforce client setup.

Read-only access for FishEye


We recommend you run FishEye as a user that has only read access to your repository.

Number of files


If you have a large number of repositories, we recommend you increase the default number of files that FishEye is allowed to open. See this knowledge base for more info: Subversion Indexer Paused with "Too many open files" Error.

Detailed installation guide

See the guidelines on Running FishEye for the First Time.

FishEye Folder Layout


By default, FishEye will run self-contained within the /FISHEYE_HOME/ directory. The FishEye directory layout looks like this:


Configuration file.


Directory under which FishEye stores its data.


Persistent information.


Caches and indexes.


Log files.


Temporary files.


Caches and indexes. (in addition to FISHEYE_HOME/var/cache)


Scripts for controling FishEye.


FishEye's dependent libraries.


Remainder omitted for brevity.

However, this self-contained layout results in tedious copying of files each time you upgrade FishEye. Also, if you want to run multiple instances of FishEye, you need multiple /FISHEYE_HOME/ installations. These two issues can be avoided by setting a FISHEYE_INST ('FishEye Instance') location.


FISHEYE_INST is a location where your repository data is stored, separate from the installation location of the FishEye application. This may be necessary for practical or administrative reasons.

(info) A separate FISHEYE_INST location is recommended for production installations of FishEye.
Once you have have declared your FISHEYE_INST, you will need to copy your FISHEYE_HOME/config.xml file to your FISHEYE_INST/ directory.

When the FISHEYE_INST environment variable is set, FishEye's directory layout becomes:



All permanent and most temporary data is found under $FISHEYE_INST/var/


Caches and indexes are found under $FISHEYE_INST/var/ (in addition to $FISHEYE_INST/var/cache)


Site-specific Java libraries (.jars) that FishEye should load on startup. (Do not copy the dependent /FISHEYE_HOME/lib/ files into here.)


Site-specific syntax highlighting definitions.


Used for setting system properties within the FishEye JVM, which may sometimes be useful for support purposes.(Note: the other way to set properties is via FISHEYE_OPTS, e.g.: export FISHEYE_OPTS=-Dpropname=value )


FishEye's dependent libraries.


FishEye bundled highlighting definitions.



Remaining files are found under /FISHEYE_HOME/.

The rest of this Installation Guide refers to $FISHEYE_INST/, but if you have not set FISHEYE_INST then it defaults to /FISHEYE_HOME/ (the directory where you extracted FishEye).