Exporting data for backup

The instructions on this page describe how to export Bamboo data for backup.

Before you begin:

  • Bamboo will be unavailable while the backup process completes. The export itself may take a long time to complete, depending on the number of builds and tests. We recommend running your backups at a time of day or night when usage is low.
  • Backups may require large amounts of disk space, depending on the number of builds and tests. Please make sure you have enough disk space in your desired backup location before proceeding.
  • Bamboo will not export if plans are currently being built.
  • User management settings for Bamboo will be saved as part of the export. For information on user management in Bamboo, see Connecting to external user directories.
  • Export Directory Path setting: Bamboo restricts the editing of certain file path settings for security reasons (see Bamboo Security Advisory 2010-05-04). If you must configure Bamboo to permit modification to its file path settings, start Bamboo with the system property bamboo.paths.set.allowed=true. The procedure for configuring a Bamboo system property is described on Configuring system properties.
    Once you have configured your file path setting, we recommend removing or disabling the bamboo.paths.set.allowed system property and restarting Bamboo. If your Bamboo instance is accessible to anyone outside your organisation, then this will minimise the risk of Bamboo being compromised by security-related attacks.

To export data for backup:

  1. Click the  icon in the Bamboo header and choose Overview.
  2. Click Export in the left navigation column (under 'System').
  3. Complete the following settings:

    Export Directory Path This can be configured – see the note above.
    File Name Edit the default name of the file to which Bamboo will export, if necessary.
    Export Results Clear this to export only the plan configurations.
    Export Artifacts Select to have Bamboo export build artifacts.
    Export Build Logs Select to have Bamboo export build logs.
  4. Click the Export. Bamboo creates the export file in the location shown for Export Directory Path.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

13 Archived comments

  1. User avatar


    Is there any way to automatically run these backups?  What are you guys using to backup your Bamboo database?

    02 Jul 2010
  2. User avatar


    Good morning,

    I want know if i can export data like jira, in XML.



    04 Feb 2014
    1. User avatar

      James Dumay [Atlassian]

      The export is zip file that contains XML files for the data Bamboos internal database.

      What do you want the XML for?

      04 Feb 2014
  3. User avatar

    Graham Pooler

    Is it possible to run this from a script (Linux) - so that it can be started by our central backup server?

    21 May 2014
  4. User avatar

    Ismael Silvestre


    I'm getting this error message when I try to make an export: Export has failed. Errors encountered while exporting: Exception initializing proxy: [com.atlassian.bamboo.resultsummary.BuildResultsSummaryImpl#22282267].

    I have try to change the backup PATH but it's not possible and the path is not valid. It's possible to make the backups manually?

    28 Jul 2014
    1. User avatar

      Paul Watson [Atlassian]

      Hi Ismael, it sounds as though your best approach is to raise a Support request at http://support.atlassian.com/. That way, you'll get fast and focussed help with this problem.

      28 Jul 2014
  5. User avatar

    Graham Pooler

    I have already opened case (and am happy for it to be made public):

    Note that the script produced in it has not been tested yet.

    29 Jul 2014
    1. User avatar

      Brian Kelley

      Graham Pooler Any chance you could post a Gist of your script?

      19 Nov 2014
  6. User avatar

    gopal krishnan

     BSP-14447 not able to view it without account.please share the details in comments for automated creation of zip with export

    05 Nov 2014
  7. User avatar

    Graham Pooler

    If I can get clearance I will gladly post it.

    19 Nov 2014
    1. User avatar

      Sultan Maiyaki [Atlassian]

      Hi Graham Pooler, I have added this as a knowledge base article that can be accessed on this link: Automating Bamboo backup operations 

      Thanks alot for the contribution.

      23 Jan 2015
  8. User avatar

    Jesse Josserand

    Is there a way to backup an individual plan within a particular project, before deleting that plan, such that it could be restored if the delete proved in appropriate for that particular plan?

    I've been tasked with cleaning up Bamboo where I work and hesitate to delete anything without making a restore-able backup 1st!

    06 Jan 2015
  9. User avatar

    Richard Cross

    "If you must configure Bamboo to permit modification to its file path settings, start Bamboo with the system propertybamboo.paths.set.allowed=true. The procedure for configuring a Bamboo system property is described on Configuring system properties."

    Actually the page "Configuring system properties" does not tell the procedure, it simply tells you which file to edit.  If you want to know HOW to configure the above system property on startup, the page you need is Configuring Bamboo on start-up and the property must be inserted as -Dbamboo.paths.set.allowed=true 

    25 Mar 2015
Powered by Confluence and Scroll Viewport