Installing Bamboo on Linux

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

In this guide we'll run you through installing Bamboo with an external database on Linux.


Other ways to install Bamboo: 

  • Evaluation - get your free trial up and running in no time.
  • Windows – install Bamboo on a Windows server. 

On this page:

Before you begin

Before you install Bamboo, there are a few questions you need to answer. 

Are you using a supported operating system?

Tell me more...

Check the Supported platforms page for the version of Bamboo you are installing. This will give you info on supported operating systems, databases and browsers.

Good to know:

  • We only support Bamboo on x86 and 64 bit x86 derived hardware platforms.
  • You will need permissions for both the Bamboo installation and home directories. 

Is your JAVA_HOME variable set correctly?

Tell me more...

Before you install Bamboo, check that you're running a supported Java version and that the JAVA_HOME environment variable is set correctly.

Bamboo can only run with the JDK (not JRE).

To check your Java version:

$ java -version

To check your JAVA_HOME variable is set correctly:

$ echo $JAVA_HOME

If you see a path to your Java installation directory, the JAVA_Home environment variable has been set correctly. If a path is not returned you'll need to set your JAVA_HOME environment variable manually before installing Bamboo.

Create a dedicated user to run Bamboo.

Bamboo runs as the user it is invoked under and can potentially be abused.

Tell me more...

An example of how to create a dedicated user to run Bamboo in Linux:

$ sudo /usr/sbin/useradd --create-home --home-dir /usr/local/bamboo --shell /bin/bash bamboo

Install Bamboo 

1. Download Bamboo

Download the file for your operating system -

  • tar.gz for MacOS or Linux distributions.
  • zip for Windows.

2. Create the installation directory

a) Extract the downloaded file to an install location.

b) The path to the extracted directory is referred to as the <Bamboo installation directory> in these instructions.

3. Create the home directory

Specify your Bamboo home directory, where your Bamboo data is stored, before you run Bamboo for the first time.

a) Create your Bamboo home directory (without spaces in the name).

Note: You should not create your Bamboo home directory inside the  <Bamboo installation directory> — they should be entirely separate locations. If you do put the home directory in the  <Bamboo installation directory>  it will be overwritten, and lost, when Bamboo is upgraded. 

b) Open <Bamboo installation directory>/atlassian-bamboo/WEB-INF/classes/

c) Uncomment the bamboo.home line.

d) Provide the absolute path to the bamboo-home directory.



4. Start Bamboo

a) In the command line, change the directory to <Bamboo installation directory> and run the commands to start Bamboo:

$ cd <Bamboo installation directory>
$ ./bin/

b) After successfully starting Bamboo, you will find it online at http://localhost:8085/ 

5. Configure Bamboo

You are starting Bamboo for the first time, so you will need to follow the Setup Wizard to configure Bamboo. See Running the Setup Wizard.

Start using Bamboo

That's it! Your Bamboo site is accessible from a URL like this: http://<computer_name_or_IP_address>:<port>

If you want your Bamboo instance always running, check how to run Bamboo as a service.

Running into problems installing Bamboo?
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.

Last modified on Oct 10, 2023

Was this helpful?

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