This is the documentation for Bamboo 5.5. View this page for the

Unknown macro: {spacejump}

of Bamboo, or visit the latest Bamboo documentation.

You can configure Bamboo to automatically create a backup each night, rather than doing a manual export every time.

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 test. 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 (see Using the Bamboo dashboard).

Specifying a backup schedule

To specify a backup schedule:

  1. Click the  icon and select Overview.
  2. Click Scheduled Backups in the left navigation column (under 'System').
  3. Click Edit to modify the schedule settings:

    SettingNotes
    Disable scheduled backupsThis check box must be cleared for automatic backups to be performed.
    Backup ArtifactsSelect if you want to include build artifacts in your scheduled backups.
    Backup pathSpecify the directory where you want to store your backups. Each backup will be stored as a single file. It may be necessary to modify the Bamboo bamboo.paths.set.allowed system property to do this.
    Note that:
    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.
    Backup file prefixSpecify the first part of the filename for all your backup files.
    Backup file date patternSpecify the date/time format for identifying your individual backup files. This will be appended to Backup file prefix to form the complete filename for your backup files.
    Schedule

    Use the Schedule Editor to choose the frequency with which backups will be performed. See Cron-based scheduling for more information about the Schedule Editor.

  4. Click Save. Your first backup will run when your server's clock matches the specified time.

Disabling a backup

If you disable schedule backups, your schedule details will be retained but no automatic backups will be performed.

To disable a scheduled backup:

  1. Click the  icon and select Overview.
  2. Click Scheduled Backups in the left navigation column. The 'Scheduled Backup Details' page will be displayed, showing details about the status of scheduled backups or any currently configured backup.
  3. Click Edit to edit the current 'Scheduled Backup Details'.
  4. Select the Disable scheduled backups check box.
  5. Click Save.

Screenshot: Scheduled backups