Bamboo 4.4 : Bamboo installation guide for Mac

This page contains instructions to help you install Bamboo on Mac OS X. If you want to use your application server, rather than the bundled Jetty server, see Bamboo EAR-WAR installation guide instead.

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 .
Before you begin

Please ensure that you have read the Requirements section of the Bamboo Installation Guide.

On this page:

1. Download and Install Bamboo

You can choose to install Bamboo via a Mac OS X Installer (.dmg) or a TGZ Archive (.tgz):

Download and install Bamboo for Mac OS X (Mac OS X Installer)

  1. Bamboo for Mac OS X is available for download from the Bamboo Download Center (click the Mac OS X tab if necessary). Choose the Mac OS X Installer (.dmg) download.
  2. Launch the Bamboo Mac OS X installer. This will mount the Atlassian Bamboo installation volume.
  3. 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.

Download and install Bamboo for Mac OS X (TGZ Archive)

  1. Bamboo for Mac OS X is available for download from the Bamboo Download Center (click the Mac OS X tab). Choose the TGZ Archive (.tgz) download (click Show all to show the TGZ Archive download link).
  2. Extract the files from the Mac OS X archive version to a Bamboo installation directory of your choice. By default, the root directory of the tgz file is "Bamboo".
  3. Set up your Bamboo home directory — this is the directory where Bamboo will store its root configuration data. To do this, open the file named bamboo-init.properties in the <Bamboo installation directory>/webapp/WEB-INF/classesdirectory. In this file, insert the property "bamboo.home", with an absolute path to your Bamboo home directory. Your file should look something like this:

    bamboo.home=/test/bamboo-home
    bamboo.jms.broker.uri=tcp://localhost:54663
    

    Alternatively, you can specify an environment variable 'BAMBOO_HOME' which specifies the absolute path to your {BAMBOO_HOME} directory. Bamboo will check if an environment variable is defined.

  4. If you are going to use Bamboo remote agents, set the following in the bamboo-init.properties file in the <Bamboo installation directory>/webapp/WEB-INF/classesdirectory:

    • Replace 'localhost' with the real host name or IP address of your Bamboo server.
    • If port number 54663 is already in use, specify a different port number.

2. Launch Bamboo on Mac OS X

There are two ways you can launch Bamboo on Mac OS X:

Launch using the bamboo.sh startup script

You can start Bamboo with the default bamboo.sh file in your installation root directory. In a terminal window, type: /Applications/Bamboo/bamboo.sh start

The bamboo.sh command accepts the following options:

  • console — this starts Bamboo in a console. The logs will scroll to standard out.
  • start — this starts Bamboo.
  • stop — this stops Bamboo.
  • status — this provides the current status of Bamboo.

Launch using the Java Service Wrapper

Alternatively, you can start Bamboo using a Java Service Wrapper, which provides services such as automatic restarting. To do this, use the run-bamboo command available in the /wrapper folder of the Bamboo installation, by typing the following in a terminal window: /Applications/Bamboo/wrapper/run-bamboo start

The run-bamboo command accepts the following options:

  • console — this starts Bamboo in a console. The logs will scroll to standard out.
  • start — this starts Bamboo.
  • stop — this stops Bamboo.
  • status — this provides the current status of Bamboo.

3. Configure Bamboo

  1. Access your running Bamboo instance by going to your web browser and entering the address: http://localhost:8085/ .
  2. Enter a license code.
  3. Configure Bamboo using the Setup Wizard. Read Running the Setup Wizard for further instructions.