Installing Bamboo on Mac OS X

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 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:

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.


Install Bamboo

1. Download Bamboo 

Download the file for your operating system - https://www.atlassian.com/software/bamboo/download

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

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/bamboo-init.properties.
c) Uncomment the bamboo.home line.
d) Provide the absolute path to your home directory.

Example:

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

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/start-bamboo.sh

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.

Troubleshooting

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 Dec 15, 2021

Was this helpful?

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