Bamboo installation guide for Linux

1. Download and install Bamboo

1. Download Bamboo for Linux. Bamboo for Linux is available for download from the Bamboo Download Center (click the 'Linux' tab).
2. Extract the files from the Linux archive to a Bamboo installation directory of your choice. By default, the root directory of the tar file is "Bamboo".

3. Set up your Bamboo home directory — this is the directory where Bamboo will store its 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
   

   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

   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.

2. Launch Bamboo on Linux

There are two ways you can launch Bamboo on Linux — using either a startup script or a Java Service Wrapper:

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

• start — this starts Bamboo.
• stop — this stops Bamboo.
• restart — this restarts Bamboo
• status — this provides the current status of Bamboo.

Launch via Java Service Wrapper

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

• console — this starts Bamboo in a console. The logs will scroll to standard out.
• start — this starts Bamboo.
• stop — this stops Bamboo.
• restart — this restarts Bamboo
• status — this provides the current status of Bamboo.
• dump — stops Bamboo abruptly by killing the process

If you have installed Bamboo on a machine with multiple interfaces, and need to bind Bamboo to a single IP address, please see Binding Bamboo to one IP address.

3. Configure Bamboo

1. Access your running Bamboo instance by going to your web browser and entering the address: http://localhost:8085/.
2. Configure Bamboo using the Setup Wizard that is displayed. Read Running the Setup Wizard for further instructions.