By enabling build expiry, you can choose how much build results data will be kept in your Bamboo system, and for how long it will be kept (e.g. for reporting purposes), before being automatically deleted.
If you disable build expiry, your build results will never be automatically deleted from Bamboo.
You can enable/disable build expiry for:
- all plans (see Enabling Expiry of Build Results). This is generally the easiest way to manage your build expiry. Your settings will apply to all plans that do not have individual expiry settings.
- individual plans (as described below). You would generally only do this if there is a specific reason to keep/delete a particular plan's build results.
Note that you can also delete build results manually — see Deleting a Build Result.
To enable expiry for a plan's build results,
If you are creating a new plan, start at step 5.
- Click 'Home' to go to the Dashboard.
- Click the 'All Plans' tab.
- Locate the plan in the list and click this icon:

- The 'Configuration' tab will be displayed. Click the 'Post Actions' sub-tab.
- The 'Post Actions' tab will be displayed. Under 'Build Expiry', check the 'Override global build expiry configuration' checkbox. The following fields will display:
- 'What should be expired?:' — select 'Artifacts' if you want to delete all user-defined artifacts but keep all other build results data. Select 'Build result' if you want to delete all build results data (including artifacts).
- Choose one of these three methods for specifying how much data to keep, using the 'Expiry period' and 'Minimum builds to keep' fields:
- To keep all build results up to a certain age,
Please note, with this method, older plans could have all their build results deleted.
- In the 'Expiry period' field, specify the number of months/weeks/days for which you want to keep your build results, e.g. specify '24 months' to keep all build results for the last two years.
- In the 'Minimum builds to keep' field, specify '0'.
- To keep a certain number of build results per plan,
- In the 'Expiry period' field, specify '0'.
- In the 'Minimum builds to keep' field, specify the number of build results you want to keep, e.g. specify '50' to keep the latest 50 build results for each plan.
- To keep all build results up to a certain age, and a certain number of build results per plan,
- In the 'Expiry period' field, specify the number of months/weeks/days for which you want to keep your build results data, e.g. specify '24 months' to keep all build results for the last two years.
- In the 'Minimum builds to keep' field, specify the number of build results you want to keep, e.g. specify '50' to keep the latest 50 build results for each plan. (This means that, even if all of a plan's builds are over two years old, the last 50 build results will not be deleted.)
- If you wish to keep builds with particular labels, check the 'Don't expire builds with certain labels' checkbox. The 'Labels to keep' field will display:
- In the 'Labels to keep' field, specify any labels for which you always want to keep labelled builds. (If you want to specify more than one label, use spaces to separate them.) For any label(s) that you specify, all builds that have a matching label will never be deleted, regardless of which of the three methods you followed for keeping and expiring data above.
Click the 'Save'/'Done' button if you are editing an existing plan. If you are creating a new plan, you can either click the 'Save'/'Done' button to create the plan without completing the rest of the wizard (check/uncheck the 'Enable Plan' checkbox to create your plan as enabled/disabled as desired) or click the 'Next' button to go to the next page:
Specifying a Plan's Permissions.
Screenshot: 'Post Actions - Enabling Build Expiry'

To disable expiry for a plan's build results data,
- Click 'Home' to go to the Dashboard.
- Click the 'All Plans' tab.
- Locate the plan in the list and click this icon:

- The 'Configuration' tab will be displayed. Click the 'Post Actions' sub-tab.
- The 'Post Actions' tab will be displayed. Under 'Build Expiry', check the 'Override global build expiry configuration' checkbox.
- Enter '999999999 months' in the 'Expiry Period' field.
This is a workaround for this existing Bamboo issue (BAM-4270). Please vote for this issue, if you would like to see it implemented in Bamboo.
- 「保存」ボタンをクリックします。
Screenshot: 'Post Actions - Disabling Build Expiry'