Bamboo 4.4 : Bamboo installation guide for Linux

This page contains instructions to help you install Bamboo on Linux. If you want to use your application server, rather than the bundled Jetty server, see the 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

  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

The wrapper is platform-specific and doesn't work on SunOS.

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

(info) 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.