View Source

This page contains instructions to help you install Bamboo on Mac.

Note that Bamboo ships with a built-in HSQL database, which is fine for evaluation purposes but is somewhat susceptible to data loss during system crashes. For production environments we recommend that you configure Bamboo to use an external database.

1. Check supported platforms

Better check the Supported platforms page first; it lists the application servers, databases, operating systems, web browsers and JDKs that we have tested Bamboo with and recommend.

Note that Atlassian currently only supports Bamboo on x86 and 64 bit x86 derived hardware platforms.

On this page:

Related pages:

Running the Bamboo Setup Wizard

2. Install Java

You will need to skip the steps below and install Java 6 manually from Apple Support.

If Java is not on your system, Mac OS X will prompt you to install it.

To get Mac OS X to install Java, run this command in a terminal:

java -version

If you receive output similar to the example below, you already have Java (The version of Java should be 1.6.0 or 1.7.x.).

If Mac OS X prompted you to install Java, you can test that it installed correctly by running the command above a second time.

Bamboo 5.6 > Installing Bamboo on Mac OS X > mac_java.png

3. Check permissions

Check your system permissions. You will need to have permissions for both the Bamboo installation and home directories.

4. Download Bamboo

Download Bamboo from the Atlassian download site. You should use the Mac OS X Installer version (.dmg).

Installing using the Mac OS X installer

Launch the Bamboo Mac OS X installer. This will mount the Atlassian Bamboo installation volume.
Launch the Bamboo Continuous Integration Server Installer.app to begin the installation wizard. The installer requires you to specify two directories:
- Bamboo installation directory— This is the directory where Bamboo's application files will be installed. The default is:
  /Applications/Bamboo
- Bamboo home directory— This is the directory where Bamboo will store its configuration data. If the directory you specify doesn't exist, Bamboo will create the directory when it launches. The default is:
  /Users/<current-user>/bamboo-home

You must use forward-slashes in your directory path. Backslashes are not recognised by Bamboo. Please ensure that the Bamboo home directory is not located inside the Bamboo installation directory.

5. Start Bamboo!

In Terminal, change directory to <Bamboo installation directory> and run this command:

bin/start-bamboo.sh

Access your running Bamboo instance by going to your web browser and entering the address: http://localhost:8085/ .

6. Configure Bamboo

Configure Bamboo using the Setup Wizard that is displayed. Read Running the Setup Wizard for further instructions.

7. Running Bamboo as a service

If you want to run Bamboo as a service, then please consult Running Bamboo as a service.