This is the documentation for FishEye 4.0. View the latest version of

Unknown macro: {spacejump}

or visit the latest FishEye documentation home page.

Skip to end of metadata
Go to start of metadata

One of the key actions you perform with FishEye is to add a new external repository. 

When you add a repository, and enable it, FishEye builds an index and cache, which may take some time to complete.

Once a repository has been added, you can then browse and search it, and further configuration options become available, depending upon the type of repository.

Add a repository

  1. Click the 'cog' menu in the FishEye header, and choose Administration (you'll need to be logged in as an administrator to see this link).
  2. Click Repositories (under 'Repository Settings').
  3. Click Native repository access, and then Add repository.
  4. Complete the wizard. See the following topics for more information:
  5. Click Add to finish.

Add a Git repository that is hosted in Bitbucket Server

You can add repositories that are hosted in Bitbucket Server to FishEye, when these servers are connected using an application link. See Integrating FishEye with Bitbucket Server for an overview.

When Bitbucket Server is integrated with FishEye:

  • You can easily add Git repositories to FishEye. The repository behaves just like a native repository in FishEye, so your team gets all the benefits of FishEye indexing, browsing and searching. 
  • The repository becomes available to Crucible (when integrated), so you can perform in-depth code reviews for changes in the repository. 
  • When you add a Bitbucket Server repository to FishEye, a push to the repository will by default automatically trigger FishEye to run an incremental index. No further configuration is required – you don't have to configure polling for new commits, or set up dedicated FishEye web hooks in your Bitbucket Server instance.

You'll need to have an account in the Bitbucket Server instance, as well as permission to view the repository that you want to add.

  1. Click the 'cog' menu in the FishEye header, and choose Administration (you'll need to be logged in as an administrator to see this link).
  2. Click Repositories (under 'Repository Settings').
  3. Click the Bitbucket repositories tab, and authenticate with Bitbucket Server if necessary.
  4. If multiple instances of Bitbucket Server are connected to FishEye, use the Bitbucket server list to choose the instance of Bitbucket Server that hosts the repository you wish to add.
  5. Optionally, type a filter pattern to restrict the list of displayed repositories to those with a matching name, key or project.
  6. Click Add for each repository that you wish to add to FishEye.

When you add a Bitbucket Server repository:

  • FishEye creates a read-only SSH key and adds that as an access key to the repository in Bitbucket Server. If this operation fails, the key will be added as a user key to your profile in Bitbucket Server. You can check if an access key was added by viewing the repository's settings in Bitbucket Server. See Using SSH keys to secure Git operations in the Bitbucket Server documentation for more information.