Bamboo Standalone Installation Guide (Mac)

To install Bamboo Standalone on Mac OS,

Step 1. Download and install Bamboo Standalone

Bamboo Standalone for Mac OS is available for download here. You can choose an Installer (.dmg) or an Archive (.tgz).

Mac OS Installer (.dmg)

1. Launching the Bamboo Mac OS installer (atlassian-bamboo-x.x-standalone.dmg) will mount the Atlassian Bamboo installation volume. Launch the Bamboo Continuous Integration Server Installer.app to begin the installation wizard.
2. 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

Mac OS Archive (.tgz)

1. To install Bamboo using the Mac OS archive version (atlassian-bamboo-x.x-standalone.tgz), you need to extract the files to a Bamboo installation directory of your choice. By default, the root directory of your tgz file is "Bamboo".
2. You will also need to setup 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/classes  directory. 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
   

   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.
3. 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/classes  directory:

   bamboo.jms.broker.uri=tcp://localhost:54663
   

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

Step 2. Launch Bamboo on Mac OS

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

1. Launch via bamboo.sh startup script

You can start Bamboo with the default bamboo.sh file in your installation root directory. The bamboo.sh command accepts the following options (e.g. ./bamboo.sh start):

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

2. Launch via Java Service Wrapper

Alternatively, you can start Bamboo via a Java Service Wrapper, which provides services such as automatic restarting. To do this, you will need to use the run-bamboo command available in the /wrapper folder of the Bamboo installation. You will need to fire the command with one of the following options (e.g. ./run-bamboo start):

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

Once Bamboo has started, you can access it by going to your web browser and entering the address: http://localhost:8085/.

Step 3. Configure Bamboo

See Running the Setup Wizard.