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.
|
1. Download and install Bamboo
- Download Bamboo for Linux. Bamboo for Linux is available for download from the Bamboo Download Center (click the 'Linux' tab).
- 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".
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 — via a startup script or via 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 Bamboostatus
— this provides the current status of Bamboo.
Launch via Java Service Wrapper
![]() | The wrapper is platform-specific and doesn't work on SunOS. |
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 start-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. ./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 Bamboostatus
— 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
- Access your running Bamboo instance by going to your web browser and entering the address:
http://localhost:8085/
. - Configure Bamboo via the Setup Wizard which will display. Read Running the Setup Wizard for further instructions.