This page contains instructions to help you install Bamboo on Windows. If you want to use your application server, rather than the bundled Jetty server, see 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 . 1. Download and install BambooBefore you begin:
Download and install Bamboo for Windows (Windows Installer)
|
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:
C:/Documents and Settings/<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 |
Download and install Bamboo for Windows (ZIP Archive)
- Download Bamboo for Windows. Bamboo for Windows is available for download from the Bamboo Download Center. Choose the ZIP Archive (.zip) download (click the 'Show all' link to show the 'ZIP Archive' download link).
Extract the files from the ZIP Archive to a Bamboo installation directory of your choice. By default, the root directory in your zip file is named "Bamboo".
Warning: Some unzip programs cause errors Some archive-extract programs cause errors when unzipping the Bamboo archive file. We highly recommend that you use the free 7Zip archive-extract program (if in doubt, download the '32-bit .exe' version).
Set up your Bamboo home directory — this is the directory where Bamboo will store its root configuration data. To do this, edit the file named
bamboo-init.properties
in theBamboo/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=C:/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
- 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.
2. Launch Bamboo
There are two ways you can launch Bamboo on Windows:
Launch via the Start Menu
If you have used the 'Windows Installer' to install Bamboo, you can start Bamboo via the Start Menu in Windows (generally under the 'Bamboo' folder by default). The following options will be available in your Start Menu:
- Bamboo Continuous Integration Server Uninstaller — uninstalls Bamboo from your computer
- Install Service — installs Bamboo as a Windows service (note, this will not start Bamboo)
- Remove Service — removes the Bamboo Windows service, if you have previously installed it (note, Bamboo will not be uninstalled from your computer)
- Start in Console — starts Bamboo in a Windows console
- Start Service — starts your installed Bamboo Windows service
- Stop Service — stops your installed Bamboo Windows service
You can run Bamboo in two modes, either in a Windows console or as a Windows service:
- To run Bamboo in a Windows console, click the Start in Console option.
To run Bamboo as a Windows service, click the Install service option. After the service is installed, click Start Service. Once you have installed Bamboo as a service, Bamboo will start up automatically every time Windows restarts.
Running Bamboo as a service - Changing the user running the Bamboo service — The default behaviour in Windows is to start the service under the SYSTEM user when Bamboo starts up. You can change this behaviour from the Services console available via the Control Panel. Please note, you may need to uninstall the service and re-install it again, if you have just upgraded or re-installed Bamboo.
- Running Bamboo as a service in Windows Vista — Bamboo ships with a service wrapper in Windows and by default, the wrapper installs itself as the NT SYSTEM user. However, in Vista the temporary directory System Variable is not available to untrusted apps. In order to run Bamboo as service in Vista, you must run Bamboo as a non-system user — see Running Bamboo service on Windows as the local user for further instructions.
Launch via batch file
You can start Bamboo via the batch files that are shipped with Bamboo. If you have installed Bamboo via the ZIP Archive, you will need to use the batch files to start Bamboo. You can find the following batch files in your installation directory:
- BambooConsole.bat — this starts Bamboo in a Windows console.
- InstallAsService.bat — this installs Bamboo as a Windows service. Note that this will not start Bamboo.
- StartBamboo.bat — this starts your installed Bamboo Windows service.
- StopBamboo.bat — this stops your installed Bamboo Windows service
- UninstallService.bat — this un-installs the Bamboo Windows service from your machine. Note that your Bamboo installation still remains.
You can run Bamboo in two modes, either in a Windows console or as a Windows service:
- To run Bamboo in a Windows console, run BambooConsole.bat
To run Bamboo as a Windows service, run InstallAsService.bat. After the service is installed, run StartBamboo.bat. Once you have installed Bamboo as a service, Bamboo will start up automatically every time Windows restarts.
Running Bamboo as a service - Changing the user running the Bamboo service — The default behaviour in Windows is to start the service under the SYSTEM user when Bamboo starts up. You can change this behaviour from the Services console available via the Control Panel. Please note, you may need to uninstall the service and re-install it again, if you have just upgraded or re-installed Bamboo.
- Running Bamboo as a service in Windows Vista — Bamboo ships with a service wrapper in Windows and by default, the wrapper installs itself as the NT SYSTEM user. However, in Vista the temporary directory System Variable is not available to untrusted apps. In order to run Bamboo as service in Vista, you must run Bamboo as a non-system user — see Running Bamboo service on Windows as the local user for further instructions.
3. Configure Bamboo
Access your running Bamboo instance by going to your web browser and entering the address http://localhost:8085/. Configure Bamboo using the Setup Wizard that is displayed. Read Running the Setup Wizard for further instructions.