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

You can change FishEye (and Crucible) settings such as password, notifications, profile image and display settings.

To change your FishEye settings,

  1. Log into FishEye.
  2. Click the User Menu (labelled with your username) at the top of the screen, then select 'Settings'. Your user settings will be displayed.
  3. Update your user settings as desired. Each tab is described in more detail below:
  4. Click the 'Close' button when you have finished updating your settings.

Screenshot: User Profile Settings

Display Settings Tab

The options in this tab allow you to amend the display settings.

Display Settings



File history view mode

Default is 'Logical'.
In Subversion repositories, FishEye is able to show all operations on a single logical file spread across a number of physical paths - i.e. operations in different branches. When this is set to 'Logical', FishEye will show all the operations across all branches. In 'Physical' mode, only the operations related to the physical path whose history is being viewed are shown.


Default is the timezone of the FishEye server.




Changesets per page

The default is 30 per page.

Always expand changesets in stream

Default is Yes.

Diff View



Diff mode

Default is 'Unified'. Can be changed to 'Side-by-side' diffs.

Line wrapping

Default is 'None' i.e. long lines will never word-wrap. 'Soft' is when long lines will word-wrap.

Context lines

Default is 3'. The number of lines to show (for context), if the diff contains more than three lines of code.

Source View



Default annotation mode

Default is 'Age'. It can be changed to 'Author' or 'None'.

Highlighting Colours

The default colour scheme uses bright colours for highlighting diffs in the code. If you prefer more muted colours, select 'Classic (muted)'.

*Tab width

Default is 8. Can be changed to a number between 1 and 10.

Profile and Email Tab



Display Name

Name displayed for the user currently logged in.

Email Address

The address all email notifications will be sent to.

Email Format

Default is text. Can be changed to be sent as HTML.

Send Watch Emails

The frequency at which emails will be sent for watch notifications:
/* 'Immediately' — The email is sent every time a change is made. This is the default value.
/* 'Daily' — You will receive a daily email summarising changes.

Profile Picture

Upload an avatar image of your choice. This image will be displayed next to your username throughout FishEye/Crucible.
Accepted formats are JPG, GIF and PNG. Image file size limit is 2Mb. Images will be automatically be cropped on upload.

Change Password Tab

Change your password via this tab, if required. Please note, the passwords are case-sensitive.

(warning) This tab will not display if your FishEye instance is connected to an external LDAP authentication source, like LDAP. You will need to contact your administrator for assistance.

Open Authentication (OAuth)

Configure your OAuth settings on this page. You can choose to allow gadgets/applications to access FishEye data using your account.

Read more about OAuth.

Author Mapping Tab

This functionality is used by Crucible.

The 'Author mapping' tab allows you to make an association between you (as a logged-in user in Crucible) and an author in each repository.

This is only necessary if the name of the user within Crucible is different to the name within the repository. Crucible will by default check to see whether the usernames match.

Watches Tab

By adding a 'watch', you can ask to receive emails about changes made to the repository. Any watches that you have set up in FishEye/Crucible will be displayed on this tab. You can watch the dashboard activity stream, changelogs and repositories. Watching an activity stream/repository allows you to receive emails when updates occur. Note, the option to add a watch may only be available if the administrator has enabled watches for the repository.

You can delete any of your watches by clicking the 'Delete' link next to the watch.

Reviews tab

This functionality is used by Crucible.

If the SMTP server is set up, then you will receive emails when different actions occur within Crucible.

You can change the options described below, to specify the stages at which emails will be sent.

Auto-mark files as 'read'

Auto-mark files as read

Default is 'Yes'. Can also be set to 'No'.

Review Notifications Events

The following options can be set to 'Immediate', 'Batch', or 'No':

State change

Default is 'Immediate'. A Crucible review moves through different states e.g: 'Draft', 'Under Review'. An email is sent when the state changes.

Comment added

Default is 'Immediate'. An email is sent when a comment is added to a review.

Participant finished

Default is 'Immediate'. An email is sent (to the Moderator only) when any reviewer has completed their review.

General message

Default is 'Immediate'. An email is sent when a reviewer is added or removed from a review, after it has gone into the 'Under Review' state.

File revision added

Default is 'Immediate'.

Batch Notifications will be sent out by Crucible every 30 minutes.  All notifications will be rolled up into a single digest e-mail.

The following options can be set to 'Yes' or 'No':

Set review to incomplete if defect is raised

Default is 'Yes'. This allows reviews to be resurrected automatically to deal with new code or defects. Can also be set to 'No'.

Set review to incomplete if revision is added

Default is 'Yes'. This allows reviews to be resurrected automatically to deal with new code or defects. Can also be set to 'No'.

My actions

Default is 'No'. If set to 'Yes', an email is sent every time you perform an action on a review.