This is the documentation for Bamboo 5.8. View this page for the

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

By enabling build expiry for a particular plan (described below), you override the global expiry settings that affect all plans in Bamboo. If you disable build expiry for a plan, that plan's build result data will never be automatically deleted from your Bamboo server.

You can choose the build result data that will be kept for a plan and for how long this data will be kept (e.g. for reporting purposes), before Bamboo automatically deletes it.

Note that the build expiry event is a global event that runs periodically, regardless of whether you disable or enable build expiry in your plans. When this event occurs, the build results for your plan will be expired according to the settings below, or globally. To configure the global event and global build expiry settings, please refer to Configuring global expiry.

You can also delete the results of a plan build manually — see Deleting the results of a plan build.

Configure the expiry of build results for a plan

Ensure that you back up your build results data before its expiry date is reached.

Configure build expiry as follows:

  1. Navigate to the configuration for the desired plan, as described on Configuring plans.
  2. Click the Miscellaneous tab.
  3. Select the Override global build expiry configuration checkbox. Configure expiry using the following settings:

    Do not expire anything for this planSelect to disable expiry for all build results and artifacts for this plan – these will never be deleted automatically.
    Build resultsAll build results data (including artifacts and build logs) are deleted.
    Build artifactsOnly user-defined artifacts are deleted from the build results.
    Build logsOnly build logs are deleted from the build results.
    Expiry afterSpecifies the period (days, weeks or months) for which you want to keep build results.
    E.g. specify '24 months' to keep all build results for the last two years.
    Minimum builds to keepSpecifies the minimum number of build results you want to keep.
    For example, specify '50' to keep the latest 50 build results, even if they are older than the period specified with Expiry period.
    Keep builds with the following labelsSpecifies the build labels (not plan labels or job labels) applied to builds for which you want to keep build results, regardless of the Expiry period and Minimum builds to keep settings. Note that builds can be labelled either manually or automatically.
  4. Click Save.

Screenshot: Configuring build expiry