All Versions
Bamboo 5.13Bamboo 5.7.x
Bamboo 5.6.x
More...
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 EAR-WAR Installation Guide instead.
On this page:
Before you begin
Please ensure that you have read the Requirements section of the Bamboo Installation Guide.
You can choose to install Bamboo via a Mac OS X Installer (.dmg) or a TGZ Archive (.tgz):
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.
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/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.
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
There are two ways you can launch Bamboo on Mac OS X:
bamboo.sh
startup scriptYou 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.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.
http://localhost:8085/
.