How to archive Bamboo project, plans or deployment projects

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

The purpose of this page explains ways to archive Bamboo project, plans or deployment project.

Environment

This is applicable for all Bamboo versions

Solution

Unfortunately, Bamboo doesn't have any built-in ways of archiving old projects, build results, plans, artifacts, etc. However, you can consider disabling or deleting your unused plans and projects.

In case you need to use your plans and their configuration at a later stage, you might consider taking a backup of your plan's configuration as Bamboo specs before deleting and using it later.

Specs don’t take logs, artifacts, or results into account; it is only about the configuration. For the logs, artifacts, and results, you could also just create a zip file of the corresponding folders (artifacts, logs) on disk and store them away. However, please keep in mind that you will not be able to restore results using Specs at a later date. So you can either take a full backup of Bamboo folders or just the configuration of the plan or deployment project using Specs.

You could also create a zip file of the corresponding project folders on disk and store them away. After that, you could run the expiry of individual plans that are part of the project to have Bamboo delete the artifacts on disk.

There is a feature request already in place to make use of personal filters in the build dashboard tab. Extend filter to exclude projects and plans with a defined label "Not in use".Bamboo could come with a predefined, exclusive label "Not in use", that one can use to label expired projects and plans and that one can select in the filter option to exclude projects and plans from being shown in the regular list. However, you need to make sure that plan expiry is not enabled for these projects and plans.

Updated on March 20, 2025

Still need help?

The Atlassian Community is here for you.