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

Unknown macro: {spacejump}

or visit the latest FishEye documentation home page.

 FishEye contains a feature that will build an archive of a directory tree. This feature is disabled by default. The 'Tarball Settings' repository option allows you to customise tarball settings in the Repository Defaults and on a per-repository basis. You can set a limit on the number of files that a tarball can contain, as well as selectively disable the creation of tarballs for certain directories or directory trees.

On this page:

Configuring tarball settings for a specific repository

To configure tarball settings for 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 the 'Repositories' link. The list of repositories set up in your FishEye instance will be displayed.
  3. Click the name of the repository, (under the 'Name' column in the list of repositories). The Repository Options for the repository will be displayed in a dialogue.
  4. Click the 'Tarballs' tab. The 'Tarballs' screen will be displayed (see screenshot below).
  5. Tick the 'Allow users to download repository trees as tarballs' checkbox, if you want to allow users to download repository trees as tarballs. The following field will be enabled:
    • 'Restrict the number of files in tarballs to' — Choose either 'No limit', or choose 'No more than <number> files' and specify the number of files.
  6. Configure 'Tarball Excludes' for your repository. The creation of tarballs will not be permitted for directories/directory trees that are excluded:
    • Click the 'Add...' link to add a new tarball exclude. Enter the 'Base Directory' and select whether to 'Exclude subdirectories' in the dialogue that displays.
    • Click the cog icon () next to a tarball exclude and click 'Edit' from the dropdown menu to edit the pattern. The editable Tarball dialogue is identical to the 'Add an Exclude' dialogue. See the Adding a Tarball Exclude section below for further instructions.
    • Click the cog icon () next to a tarball exclude and click 'Delete' from the dropdown menu to delete the tarball exclude.
  7. Save your changes.

Screenshot: Configuring watches for a specific repository

Configure tarball settings for all repositories

To configure watches for all repositories,

  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 the 'Defaults' link. The 'Repository Defaults' will be displayed.
  3. Click the 'Tarballs' tab. The 'Tarballs' screen will be displayed (see screenshot below).
  4. Tick the 'Allow users to download repository trees as tarballs' checkbox, if you want to allow users to download repository trees as tarballs. The following field will be enabled:
    • 'Restrict the number of files in tarballs to' — Choose either 'No limit', or choose 'No more than <number> files' and specify the number of files.
  5. Configure 'Tarball Excludes' for your repository. The creation of tarballs will not be permitted for directories/directory trees that are excluded:
    • Click the 'Add...' link to add a new tarball exclude. Enter the 'Base Directory' and select whether to 'Exclude subdirectories' in the dialogue that displays.
    • Click the cog icon () next to a tarball exclude and click 'Edit' from the dropdown menu to edit the pattern. The editable Tarball dialogue is identical to the 'Add an Exclude' dialogue. See the Adding a Tarball Exclude section below for further instructions.
    • Click the cog icon () next to a tarball exclude and click 'Delete' from the dropdown menu to delete the tarball exclude.
  6. Save your changes.

Screenshot: Configuring tarball settings for all repositories