This is the documentation for Crucible 3.3. View the latest version of

Unknown macro: {spacejump}

or visit the latest Crucible documentation home page.

This page gives an overview of the joint installation of Crucible and FishEye. Both Crucible and FishEye are Atlassian products.

  • FishEye allows you to extract information from your source code repository and display it in sophisticated reports.
  • Crucible allows you to request, perform and manage code reviews.
  • Both of these products can run in isolation. If you are using Subversion, Git, Mercurial, CVS or Perforce you can significantly enhance your Crucible experience by also using FishEye.

Your Crucible installation package includes the files required for FishEye

If you use FishEye and Crucible together, they run as one instance.

Purchasing and installing Crucible/FishEye

  • If you install Crucible, there is no need to do a separate installation of FishEye.
  • Upgrading Crucible to also use FishEye requires only a simple licence change in the admin area.
  • Upgrading an existing FishEye installation to also use Crucible requires a Crucible install. You can either keep the original FishEye installation or install Crucible and FishEye as a fresh install. Refer to the guide on upgrading from FishEye to Crucible.

The <Crucible home directory> and FISHEYE_INST

Throughout the Crucible documentation, references are made to the <Crucible home directory>, which refers to the location of the Crucible application. Be aware that, when Crucible is run with FishEye, this location is equivalent to the location referred to by <FishEye home directory> in the FishEye documentation.

Crucible also makes use of this FishEye environment variable:

  • FISHEYE_INST – the location of the FishEye data.

Refer to the FishEye documentation for more about the environment variables.

Installing the Crucible binary files

See the following for Crucible install instructions:

Setting up a repository for use with stand-alone Crucible

For complete instructions, see Configuring repositories.

Setting up a Repository for use with FishEye and Crucible

If you intend to use Crucible and FishEye with:

Detailed Documentation

You can find more information in: