Skip to end of metadata
Go to start of metadata

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 and select Overview.
  2. Click Export in the left navigation column (under 'System').
  3. Complete the following settings:

    Export Directory PathThis can be configured – see the note above.
    File NameEdit the default name of the file to which Bamboo will export, if necessary.
    Export ResultsClear this to export only the plan configurations.
    Export ArtifactsSelect to have Bamboo export build artifacts.
    Export Build LogsSelect to have Bamboo export build logs.
  4. Click the Export. Bamboo creates the export file in the location shown for Export Directory Path.

Screenshot: Exporting data for backup



  1. Anonymous

    v2.2.1 Just completed a 25G backup apparently successfully after accidentally checking add artifacts.

  2. Anonymous

    The exporting breaks with the following error:

    Export has failed. Errors encountered while exporting. Adding text to an XML document must not be null.

    The bamboo.log contains the following Error:

    [Export] java.lang.IllegalArgumentException: Adding text to an XML document must not be null
    java.lang.IllegalArgumentException: Adding text to an XML document must not be null

    Tested it with and without the 'Export Artifacts' chekced

    1. Hello there,

      Apologies for the delay in replying. If you do have a problem with this function in Bamboo, could you please log a customer support query via the Get Support link below and please attach your bamboo.log file to your support issue.

      Kind regards,
      Giles Gaskell.

  3. Anonymous

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

  4. Anonymous

    Good morning,

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



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

      What do you want the XML for?