Quick-Start Guide

This guide will explain how to get FishEye installed and running as easily as possible. For more advanced installation topics, see the installation guide.

Install FishEye

Download the FishEye zip file and extract it. This document assumes you have extracted FishEye to /FISHEYE_HOME/.
Ensure you have installed an appropriate Java runtime, see Requirements. Ensure that java is in the PATH, or that the JAVA_HOME environment variable is set.
Copy your fisheye.license file to /FISHEYE_HOME/. You can download a trial license here.

Run FishEye

Note

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

You can start FishEye immediately with the following:

$ cd /FISHEYE_HOME/bin
$ ./run.sh

(Use run.bat on Windows)

Once started, FishEye will run its own HTTP webserver on port 8080. You can access FishEye immediately by going to http://HOSTNAME:8080/ in a browser.

Note

By default, FishEye will listen on port 8080 for HTTP requests. It also listens on 127.0.0.1:8079 as a control port. You can configure both of these in the admin pages, or by editing /FISHEYE_HOME/config.xml and restarting FishEye.

Setup FishEye

The first time you access FishEye from a browser, you will be required to enter an administrator password. This password will give you access to the FishEye admin pages.

Once you have setup an administrator password, you can access the admin pages at http://HOSTNAME:8080/admin/. One of the first steps will be to add a repository.

Using FishEye

Once you have added a repository, you can view it in FishEye at http://HOSTNAME:8080/. FishEye needs to build an index and cache of the contents of your repository, so some information will not appear in FishEye until this is complete.

Stopping FishEye

Use stop.sh (or stop.bat on Windows) to stop the FishEye server:

$ cd /FISHEYE_HOME/bin
$ ./stop.sh