Locating Important Directories and Files

On this page:

BAMBOO SERVER

When you installed your Bamboo server, you specified two directories:

• Bamboo installation directory — This is the directory where the Bamboo application files are installed. (The default location depends on your operating system: Windows, Unix/Linux, Solaris or Mac OS.)
• Bamboo home directory — This is the directory where your Bamboo configuration data and build results are stored. (The default location depends on your operating system: Windows, Unix/Linux, Solaris or Mac OS.) This directory can grow quite large when managing large quantities of plans and builds.

The most important contents of these two directories are described below.

Bamboo home directory

• bamboo.cfg.xml — This is Bamboo's core configuration file. It includes the configuration information for connecting to Bamboo's database.
• xml-data/ — This directory contains all files relating to source repositories and build results.
  • xml-data/build-dir/JOB_KEY — This is known as the Working Directory. This is where Bamboo temporarily puts the checked-out files it is building. The location of this directory was specified via the Setup Wizard, can be viewed as described in Viewing Bamboo's System Information, and can be changed as described in Specifying Bamboo's Working Directory.
  • xml-data/builds/ — This is known as the Build Directory. This is where Bamboo stores build results and artifacts (note that they will be deleted as described in  Configuring Global Expiry of Job Build Results). The location of this directory was specified via the Setup Wizard, and can be viewed as described in Viewing Bamboo's System Information. Its contents can be backed up as per Exporting Data for Backup.
    • xml-data/builds/JOB_KEY/results — Contains the build results for all the builds belonging to the 'JOB_KEY' plan. Each build result is an individual XML file. Do not edit these files or the corresponding information in the database may become corrupt.
    • xml-data/builds/JOB_KEY/download-data — Contains the artifacts and logs for each build belonging to the 'JOB_KEY' plan.
  • xml-data/configuration/ — This is known as the Configuration Directory. It contains server-wide configuration information. The location of this directory was specified via the Setup Wizard, and can be viewed as described in Viewing Bamboo's System Information. Its contents can be backed up as per Exporting Data for Backup.
• database/ — This directory contains Bamboo's embedded HSQL database. The database contains plan configurations and some build results data.
• index/ — This directory contains the build results index. Removing or modifying files in this directory may corrupt build history. Rebuilding the search index from Bamboo's global administration screen (see Optimising or Re-indexing Data) will completely regenerate the contents of this directory.

Bamboo installation directory

• webapp/WEB-INF/classes/bamboo-init.properties — This file tells Bamboo where to find the Bamboo home directory. The location of this directory is specified by the Bamboo administrator as described in the Bamboo Installation Guide, and can be viewed as described in Viewing Bamboo's System Information.
• bamboo.sh * — This is the startup file for Bamboo Standalone under Unix/Linux, Solaris and Mac OS.
• bamboo.bat * — This is the startup file for Bamboo Standalone under Windows.
• bamboo.pid * — This file, under Linux, contains the Process ID for the running instance of Bamboo.
• conf/wrapper.conf * — This file provides the means to configure Bamboo on startup, when using the Java Service wrapper under Linux or Windows.
• scripts/ — This directory contains operational scripts, including scripts for CVS and SVN triggers.
• wrapper/* — This directory contains the necessary files to start Bamboo using the Java Service wrapper (see the Mac and Linux installation guides).
• logs/*--- This directory contains logs written by the Java Service wrapper. (Note: The Bamboo server logs are written to the root of the installation directory. Build logs are stored in the xml-data/builds/ sub-directories.)
• webapp/ — This directory  contains all the Bamboo server application files.
• webapp/WEB-INF/lib/ — This directory is used when deploying Bamboo plugins. It also contains other libraries required by Bamboo.
• webapp/WEB-INF/classes/log4j.properties — This is Bamboo's logging configuration file.
• webapp/WEB-INF/classes/jetty.xml * — This is the configuration file for Jetty, the application server that is bundled with Bamboo Standalone.

* This applies to the Bamboo Standalone distribution. The configuration may differ for the Bamboo EAR-WAR distribution.

BAMBOO AGENT

Bamboo agent home directory

When you installed your remote agents (if any), you specified the following directory:

• Agent home directory — This is the directory where the agent's configuration data is stored. The default name of this directory is  bamboo-agent-home. (The default location depends on your operating system: Windows, Unix/Linux, Solaris or Mac OS.) This directory can grow quite large when managing large quantities of plans and builds. 

The contents of the agent home directory are:

• bamboo-agent.cfg.xml — This contains configuration information about this remote agent. Most notably, it stores the agent id, which gets generated the first time this agent connects to the Bamboo server.
• xml-data/
  • xml-data/build-dir/ — This is where the agent will check out the files and peform builds (similar to the Bamboo server's xml-data/build-dir/ directory)