This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

Before you begin:

  • Bamboo will be unavailable while the export process completes. Depending on the number of builds and tests, the export may take a long time to complete and may require large amounts of disk space. Please make sure you have enough disk space before proceeding.
  • Bamboo will not export if it detects that plans are currently being built. Please ensure that you do not have plans building (see Viewing Bamboo's Current Activity).
  • There is a bug in Bamboo 1.2 which causes the dependency associations to not be exported along with the plans. If you are using Bamboo 1.2, please upgrade to Bamboo 1.2.1 for a fix.
  • Bamboo uses the third party TrueZip library to create zip archives. TrueZIP currently implements the ZIP32 specification only. This limits the maximum ZIP file length to 4GB. Unfortunately, Bamboo exports will fail if the resulting ZIP file is over 4GB. As a workaround, please export Bamboo without artifacts or use a different backup strategy
  • Exporting Bamboo doesn't work with Bamboo versions prior to 1.2.2, if LDAP is turned on. If you want to export Bamboo data, please turn off LDAP. Please see Integrating Bamboo with LDAP for further details.

To export data for backup,

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Export link in the left navigation column.
  3. Specify the absolute 'Export Directory Path' to which Bamboo will export its data. For example, 'C:\Documents and Settings\<me>\bamboo-home\my-backups' for a Windows-based operating system. You would typically use forward-slashes (without drive letter specification) on UNIX-based operating systems.
    (info) Due to a tightening of the Bamboo security model, Bamboo may not initially allow you to edit this field. If this is the case, you must first configure Bamboo to permit modification to its file path settings. To do this:
    1. Start Bamboo with the system property bamboo.paths.set.allowed=true, by following the procedure for configuring a Bamboo system property.
    2. Restart this procedure from step 1 (above).
  4. Type the 'File Name' of the file to which Bamboo will export its data. For example, 'export.zip'.
  5. Select the 'Export Artifacts' check box if you want to backup your build artifacts.
  6. Click the 'Export' button.

If your Bamboo instance is publicly accessible or is accessible to anyone outside your organisation, then to minimise the risk of Bamboo being compromised by security-related attacks, we recommend restarting Bamboo without the system property bamboo.paths.set.allowed=true (or with this system property disabled). Please refer to Configuring System Properties for details on configuring Bamboo's system properties.

Screenshot: Export



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.