Installing FishEye on Windows
... describes how to perform a clean install of FishEye on Windows.
If you're upgrading your FishEye installation, read the FishEye upgrade guide first.
Using Linux or Mac OS X?
If you're on one of these platforms read Installing FishEye on Linux and Mac instead.
1. Check supported platforms
Better check thepage first; it lists the application servers, databases, operating systems, web browsers and JDKs that we have tested FishEye with, and that we recommend.
Atlassian only officially supports FishEye running on x86 hardware and 64-bit derivatives of x86 hardware.
2. (recommended) Create a dedicated FishEye user
For production installations, we recommend that you create a new dedicated Windows user that will run FishEye on your system. This user:
- Should not have admin privileges.
- Should be a non-privileged user with read, write and execute access on the FishEye install directory and instance (data) directory. These directories are described below.
- Should only have read access to your repositories.
If you have created a dedicated FishEye user, ensure you are logged in as this user to complete the remaining instructions.
3. Decide which version of Java you want to use
3.1 Use the embedded JRE
FishEye ships with a version of JRE bundled that will permit you to install and run it without the need of installing a JVM on your server.
In case you decide to use the embedded JRE you can skip to the next chapter.
3.2 Manually install a JVM
In case you decide to manually install a JVM first make sure you do not have a pre-existing installation already in place.
In a command prompt, run this:
The version of Java should be 1.8.x.
Download and install the Java Platform JDK from Oracle's website.
We recommend that the Java install path should not contain spaces, so don't install into C:\Program Files\Java\. Instead, use a path like C:\Java.
Now try running '
java -version' again to check the installation. The version of Java should be 1.8.x.
4. Check that Windows can find Java
Windows uses the JAVA_HOME environment variable to find Java. To check that, in a new command prompt, run:
You should see a path to the Java install location. We recommend that this path does not contain spaces, and that JAVA_HOME should point to the JDK home path.
If you see a path with spaces, like
C:\Program Files\Java\, then sorry, but go back to 3. and reinstall Java to a location that doesn't have spaces.
- If you don't see a path at all, or if you just see %JAVA_HOME%, then set JAVA_HOME as follows:
For Windows 7:
- Go to Start, search for "sys env" and choose Edit the system environment variables.
- Click Environment Variables, and then New under 'System variables'.
- Enter "JAVA_HOME" as the Variable name, and the absolute path to where you installed the Java JDK as the Variable value, that is, something like
C:\Java\jdk1.7.0_51. Don't use a trailing backslash. We recommend that JAVA_HOME should point to the JDK home path.
- Now, in a new command prompt, try running '
java -version'. You should see the same version of Java as you saw above.
4.1 Set JAVA_HOME when using the embedded JRE
In case you did not install and additional JVM and want to run FishEye using the embedded JRE you will still need to setup the JAVA_HOME environment variable for your server.
In that case you can setup the JAVA home variable to point to
The installer creates the
FISHEYE_HOME system environment variable. This points to the location of the installation files directory.
The default location for the installation files directory (
C:\Atlassian\fecru-x.y.z (where x.y.z is the version you installed on your server).
5. Now it's time to get FishEye
The recommended way to install FishEye is to use the installer, which installs FishEye as a Windows service.
Download the FishEye installer from the Atlassian download site.
There are 32-bit and 64-bit installers for FishEye on Windows. Each installer adds FishEye as a Windows service, and starts the service, automatically. The express install creates, by default, a
Data directory and a separate install directory in
C:\Atlassian. The custom install mode allows you to choose different locations for the install and
Data directories, with the restriction that the
Data directory must not be contained in the install directory.
- The installer creates the
FISHEYE_INSTsystem environment variable. This points to the location of the instance (data) directory.
- The path to the installation location is referred to as the
<FishEye install directory>
- You need separate FishEye instance (data) directories if you want to run multiple copies of FishEye.
- If you expect to have a large number of users for this FishEye installation, and FishEye will be connected to an external database, consider installing FishEye on a different server from the one running the external database, for improved performance.
- If you have a large number of repositories, we recommend you increase the default number of files that FishEye is allowed to open. See the following knowledge base article for more info: Subversion Indexer Paused with "Too many open files" Error.
For FishEye 3.4.4 and later, you can edit JVM parameters for the Windows service by going to Start > All Programs > FishEye > Configure FishEye. Ensure that you restart the FishEye service when finished. Do not reference any environment variables in the settings (e.g. %FISHEYE_INST%). Instead, set the actual path.
6. Visit FishEye!
Give the FishEye service a minute to launch. Then, in a web browser on the same machine, go to
http://localhost:8060/ (or, from another machine, type
hostname is the name of the machine where you installed FishEye).
Enter your license, then an admin password, to finish the setup. Note that this password is for the 'built-in' FishEye admin user. You can log in as this user, if necessary, by clicking the Administration link in the page footer. See also How to reset the Administration Page password in FishEye or Crucible.
You can postpone setting up JIRA integration until later if you wish; see
7. Add repositories
Now you can tell FishEye about any existing repositories you have. Please read Starting to use FishEye for the details.
FishEye will perform an initial index of your repositories, during which it accesses, indexes and organizes a view of your repositories (including all historical items) back to the earliest commits. If you are evaluating FishEye, we suggest that you index a single project, so you can use FishEye as soon as possible. If you choose to index your entire repository, be aware that this can take a long time (possibly days) for massive or complex repositories and can be more complex to set up (especially for Subversion). The basic process is slightly different for each SCM type.
8. Add users and groups
9. Set up your mail server
Configure the FishEye email server so that users can get notifications from FishEye. See
10. Connect to an external database (recommended)
If you intend to use this FishEye installation in a production environment, it is highly recommended that you use one of the supported external databases. See
11. Stop FishEye (optional)
Control the FishEye service from the Windows administration console. Alternatively, in a command prompt, change directory to
<FishEye install directory> and run this:
12. Tuning FishEye performance
To get the best performance from your new FishEye installation, please consult Tuning FishEye performance.