Installing Bamboo on Mac OS X

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

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:


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.


1. Download Bamboo 

  1. Download the Bamboo tar.gz archive.
  2. Extract the downloaded file to a selected location.
    The path to the extracted directory is referred to as the <Bamboo installation directory> in these instructions.

2. Specify your Bamboo home location

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).

:  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 your home directory.

bamboo.home= /home/nathan/bamboo/bamboo-home

3. Start Bamboo

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


b) In your Web browser, enter the following address: http://localhost:8085/

4. Configure Bamboo

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>

Here's a few things that will help you get your team up and running:


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 13, 2017

Was this helpful?

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