Locating important directories and files
On this page:
Bamboo installation directory
When you installed Bamboo, you specified the location for the Bamboo installation directory, where Bamboo application files are stored. The default location depends on your operating system: Windows, Unix/Linux, or macOS.The Bamboo installation directory contains the following files:
atlassian-bamboo/WEB-INF/classes/bamboo-init.properties
This file tells Bamboo where to find the Bamboo home directory. The location of the containing directory is specified by the Bamboo administrator as described in the Bamboo installation guide. For more information, see Starting Bamboo.bin/start-bamboo.sh
This is the startup file for Bamboo under Unix/Linux, Solaris, and Mac OS.bin\start-bamboo.bat
This is the startup file for the Bamboo under Windows.scripts/Triggers
This directory contains operational scripts used when configuring the repository to trigger a Bamboo build.logs/*
This directory contains logs unless you have used the binary installer for Windows.Bamboo server logs are written to the root of the installation directory. Build logs are stored in the subdirectories under
<BAMBOO_HOME>/xml-data/buildsin Bamboo 7 and under<SHARED_HOME>/buildsin Bamboo 8.For more information, see Build locations.
If you used the binary installer for Windows, the log file will be located at
%USERPROFILE%\bamboo.log.For Bamboo running as a Windows service, it's at
%WINDIR%\System32\Config\systemprofile\bamboo.log.atlassian-bamboo/WEB-INF/lib/
This directory is used when deploying Bamboo apps. It also contains other libraries required by Bamboo.atlassian-bamboo/WEB-INF/classes/log4j2.properties
This is the Bamboo logging configuration file. You can also configure logging Bamboo UI by navigating to > Log Settings page, but the changes made on that page will be reverted by a Bamboo restart; however, changes made in thelog4j2.propertiesfile will persist even after a restart.
Bamboo local home directory
When you installed Bamboo, you specified the location for the Bamboo local home directory, where your Bamboo configuration data and build results are stored. The default location depends on your operating system: Windows, Unix/Linux, or macOS. This directory can grow quite large when managing large quantities of plans and builds.Bamboo 8 introduced major changes to the structure of the home folder. The new organization is a requirement for using multiple nodes with Bamboo Data Center, but it affects every type of Bamboo installation, including Server and single-node Data Center setups. You can future-proof your tools by using the Plan directory information REST API.
Common locations and files in the local home directory
The Bamboo home directory contains the following common subdirectories and files:bamboo.cfg.xml
This is Bamboo's core configuration file. It includes the configuration information for connecting to Bamboo's database.database/H2 is intended for evaluation purposes only and isn't recommended for production instances of Bamboo.
logs/*
This directory contains logs unless you have used the binary installer for Windows. The Bamboo server logs are written to the root of the installation directory. Build logs are stored in the subdirectories underxml-data/builds/.If you used the binary installer for Windows, the log file will be located at
%USERPROFILE%\bamboo.log.For Bamboo running as a Windows service, it's at
%WINDIR%\System32\Config\systemprofile\bamboo.log.
Build locations
The following table lists the build locations that you can find in the Bamboo local or shared home directories, depending on which version of Bamboo you are running. For a complete list of what has changed in the structure of the home directory, see Bamboo home migration.| Bamboo 7.x | Bamboo 8.x | ||
|---|---|---|---|
| 1 | Path | index/ | <SHARED_HOME>/index/ |
| Description | This directory contains the build results index. Removing or modifying files in this directory may corrupt build history. Rebuilding the search index from the global administration page (see Reindexing data) will completely regenerate the contents of this directory. | ||
| 2 | Path | artifacts/<PLAN_KEY>/shared/build-<BUILD_NUMBER> | <SHARED_HOME>/artifacts/<PLAN_KEY>/shared/build-<BUILD_NUMBER> |
| Description | This location is shared by all the stages of a plan. Stages will place artifacts here so that other stages from the same plan can have access to them. The <BUILD_NUMBER> always consists of a minimum of 5 digits with leading zeroes when necessary. For example, for build "42" the number will be "00042". | ||
| 3 | Path | xml-data/build-dir/<JOB_KEY> | <BAMBOO_HOME>/local-working-dir/<JOB_KEY> |
| Description | This location is known as the working directory. This is where Bamboo temporarily puts the checked-out files it's building. The path of this directory can be changed as described in Specifying Bamboo's Working Directory. | ||
| 4 | Path | xml-data/builds/ | <SHARED_HOME>/builds |
| Description | This location is known as the build directory. This is where Bamboo stores build results, which are deleted as described in Configuring global expiry. Its contents can be backed up as described in Exporting data for backup. | ||
| 5 | Path | xml-data/builds/<JOB_KEY>/results | <SHARED_HOME>/builds/<JOB_KEY>/results |
| Description | Contains the build results for all the builds belonging to the plan identified by <JOB_KEY>. Each build result is an individual XML file. Don't edit these files or the corresponding information in the database may become corrupt. | ||
| 6 | Path | xml-data/builds/<JOB_KEY>/download-data | <SHARED_HOME>/builds/<JOB_KEY>/download-data |
| Description | Contains the logs for each build belonging to the plan identified by the <JOB_KEY>. | ||
| 7 | Path | xml-data/configuration | <SHARED_HOME>/configuration |
| Description | This is known as the configuration directory. It contains server-wide configuration data. Its contents can be backed up as described in Exporting data for backup. | ||
Bamboo agent home directory
When you installed your remote agents (if any), you specified the location for the Agent home directory, where the configuration data of agents is stored. The default name of this directory isbamboo-agent-home. This directory can grow quite large when managing significant numbers of plans and builds. The default bamboo-agent-home location depends on your operating system: Windows, Unix/Linux, or macOS.The Bamboo agent home directory contains the following subdirectories and files:
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/build-dir/
This is where the agent will check out the files and perform builds (similar to the Bamboo server'sxml-data/build-dir/directory)