Documentation for Bamboo 4.1.x. Documentation for earlier versions of Bamboo is available too.

1. Check the system requirements

Supported platforms

Please read the Supported platforms page before you install Bamboo. The Supported Platforms page lists the applications servers, databases, operating systems, web browsers and JDKs that we have tested Bamboo with and recommend.

Hardware requirements

While some of our customers run Bamboo on SPARC-based hardware, Atlassian only officially supports Bamboo running on x86 hardware and 64-bit derivatives of x86 hardware.

Servlet container requirements

If you are using the Bamboo EAR-WAR distribution, you will need a servlet container that supports the Servlet 2.4 specification. Most modern containers should comply to this.

On this page:

Related pages:

2. Choose your Bamboo distribution

Bamboo is available in two 'distributions' — Bamboo or Bamboo EAR-WAR. The Bamboo distribution is recommended (even for organisations with an existing application server environment).

Bamboo distribution

  • Pre-packaged with the Jetty application server
  • Requires virtually no setup
  • Recommended for all users

Bamboo EAR-WAR distribution

  • Deploys into an existing application server
  • Requires manual configuration
  • Suitable only for system administrators

3. Installation and setup

Installation and setup for Bamboo distribution

Installation and setup for Bamboo EAR-WAR distribution

EAR-WAR Installation Guide

Checking for known issues and troubleshooting the Bamboo installation

If something is not working correctly after you have completed the steps above to install Bamboo, please check for known Bamboo issues and try troubleshooting your upgrade as described below:

  • Check for known issues. Sometimes we find out about a problem with the latest version of Bamboo after we have released the software. In such cases we publish information about the known issues in the Bamboo Knowledge Base. Please check the known issues in the Bamboo Knowledge Base and follow the instructions to apply any necessary patches if necessary.
  • Did you encounter a problem during the Bamboo installation? Please refer to the guide to troubleshooting upgrades in the Bamboo Knowledge Base.
  • If you encounter a problem during the upgrade and cannot solve it, please create a support ticket and one of our support engineers will help you.

3 Comments

  1. Bob Swift

    Jul 21, 2008

    Does the warning about using SUN JDK apply to remote agents? Is there a list of problems somewhere or an issue to remove this restriction?

    1. AjayA

      Jul 23, 2008

      Hi Bob,

      Does the warning about using SUN JDK apply to remote agents?

      Yes, it applies to the remote agents as well.

      Is there a list of problems somewhere

      To be quite honest, we haven't fully tested Bamboo on Non-Sun JDK and are not sure of the potential problems - but there are a few JIRA issue floating around (See BAM-2464)

      or an issue to remove this restriction?

      Unfortunately, this is currently not on the Bamboo road map for the next year or so.

      Cheers,
      Ajay.

  2. Kim Waldorff Østergaard

    May 22, 2012

    Never mind...



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.