Bamboo Best Practice - System Requirements
The recommendations in this guide are not universal and the final configuration of your Bamboo instance will depend on your specific use case.
System requirements & considerations
CPU and memory
For Bamboo, the minimum CPU and memory requirements depend on the size and complexity of your plans. You need to consider:
- Will your builds have functional tests as part of the plans?
- Are your plans executed simultaneously? If so, how many plans will be running at any given time?
- What are the requirements for your running builds, for example, do they need large amounts of memory/disk/swap space?
- How many users will be using Bamboo at any given time? Like any web application, the system resource needed is proportional to the load experienced by the server.
- How many local agents do you plan on running?
|4 core, 4 GB RAM
|8 core, 8 GB RAM, remote agent use
Multiple small teams/
|8 core, 16 GB RAM, more remote agents
Multiple large teams/
|16 core, 16 GB RAM, all remote agents
The Bamboo installation size is approximately 140 MB, however, Bamboo's storage requirements depend upon its usage pattern during use. The usage pattern depends on factors such as:
- How many plans you will run
- How many tests each plan will execute
- How many artifacts you are going to have and their size
Atlassian recommends that you allocate about 20 GB on top of the Bamboo installation size, and evaluate your usage patterns. Where usage is likely to grow, consider adding additional storage.
Bamboo is a pure Java application and should run on any platform, provided all the JDK requirements are satisfied.
The Supported platforms page lists the server and client software, and their versions, supported by .
Bamboo requires the full Java Developers Kit (JDK) platform to be installed on your server's operating system.
Bamboo is a web application that requires an application server. Currently, Apache Tomcat is supported. Tomcat is a stable, lightweight, and fast performing application server, however, please note the following:
- Deploying multiple Atlassian applications in a single Tomcat container is not supported. We do not test this configuration and upgrading any of the applications (even for point releases) is likely to break it. There are also a number of known issues with this configuration (see this FAQ for more information).
- We also do not support deploying multiple Atlassian applications to a single Tomcat container for a number of practical reasons. Firstly, you must shut down Tomcat to upgrade any application, and secondly, if one application crashes, the other applications running in that Tomcat container will be inaccessible.
- Finally, we recommend not deploying any other applications to the same Tomcat container that runs Bamboo, especially if these other applications have large memory requirements or require additional libraries in Tomcat's
Bamboo requires a relational database to store its data. Bamboo supports the most popular relational database servers, so we suggest using the one that you are most comfortable with administering. Bamboo ships pre-configured with an integrated HSQL database for evaluation purposes only. Since HSQLDB is prone to database corruption, we recommend configuring an external database for production environments.
Hence, if you intend to use Bamboo in a production environment, we strongly recommend that you connect Bamboo to a supported enterprise database system.
Bamboo also requires a number of services for efficient operation. You need to consider:
- Build log size
- Database connection pool size.
- Number of local agents.
- Number of remote or elastic agents.
Build log size considerations
In Bamboo, ActiveMQ is configured as a persistent queue, and messages sent over ActiveMQ are written to disk in the
$BAMBOO_HOME/shared/jms_store directory. Build logs are sent over this queue, and large volumes of logs can slow the queue as it attempts to persist the message to disk. If the queue slows sufficiently it can cause the agent message broker to stop responding to other agents. This may present as large numbers of agents suddenly disconnecting from the server without any errors appearing in the server logs, and failing to reconnect until the server is restarted.
Typically any log that is 100MB+ is a cause for concern, although large numbers of logs slightly smaller than this limit may cause similar issues.
Database connection pool size
The number of database connections available to Bamboo is the lower of two values: your DBMS connection limit and the configured Bamboo connection pool size. From Bamboo 4.2 and later, the Bamboo connection pool size has a default value of 100.
For a small to medium instances (~5 concurrent users, ~5 busy/building local agents, 20 remote agents, 50 plans), the default values are sufficient.
You should increase the connection limit if you notice UI freezes or general sluggish UI performance. Do not decrease the number of available connections below 25.
Note that having too many connections available to Bamboo carries no performance penalty as long as your DBMS can handle the load.
Example: How to estimate the number of db connections
The following formula gives a rough estimate of the number of database connections that will be required:
(Concurrent users)/5 + (Busy remote agents)/5 + (Local agents)*1.1 + (Amount of concurrent change detections)
For example, an instance with:
- 5 concurrent users
- 30 busy remote (or elastic) agents
- 30 busy local agents
- 60 plans with repository polling set to 60-second intervals (assume 3 seconds per change detection)
would require 1 + 6 + 33 + 3 = 43 connections.
Bamboo ships with a pre-configured connection limit, however this can be modified by editing the following value in your bamboo.cfg.xml file:
Local agents considerations
If you run more than 5 concurrently building local agents, you'll probably need to adapt the connection limit because each busy local agent requires a live database connection.
Also, note that large amounts of busy (building) local agents can negatively influence the performance of a Bamboo server (and other services running on that host).
Remote and elastic agent considerations
Remote and elastic agents do not require special database connection settings.