Locating important directories and files

The information on this page describes how to find important Bamboo 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: WindowsUnix/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/builds in Bamboo 7 and under <SHARED_HOME>/builds in 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 the log4j2.properties file 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: WindowsUnix/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/
    This directory contains Bamboo's embedded H2 database. The database contains plan configurations and some build results data. This directory is not present if an external database is used instead of the embedded H2.

    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 under xml-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.xBamboo 8.x
1Pathindex/<SHARED_HOME>/index/
DescriptionThis 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.
2Pathartifacts/<PLAN_KEY>/shared/build-<BUILD_NUMBER><SHARED_HOME>/artifacts/<PLAN_KEY>/shared/build-<BUILD_NUMBER>
DescriptionThis 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".
3Pathxml-data/build-dir/<JOB_KEY><BAMBOO_HOME>/local-working-dir/<JOB_KEY>


DescriptionThis 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.
4Pathxml-data/builds/<SHARED_HOME>/builds
DescriptionThis 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.
5Pathxml-data/builds/<JOB_KEY>/results<SHARED_HOME>/builds/<JOB_KEY>/results
DescriptionContains 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.
6Pathxml-data/builds/<JOB_KEY>/download-data<SHARED_HOME>/builds/<JOB_KEY>/download-data
DescriptionContains the logs for each build belonging to the plan identified by the <JOB_KEY>.
7Pathxml-data/configuration<SHARED_HOME>/configuration
DescriptionThis 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 is bamboo-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: WindowsUnix/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's xml-data/build-dir/ directory)


Last modified on Oct 13, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.