Bamboo Standalone Installation Guide (Windows)

Before you begin:

• Please ensure that you have read the Requirements section of the Bamboo Installation Guide.
• Note, you can choose to install Bamboo via a Windows Installer(.exe) or a ZIP Archive (.zip).

Download and Install Bamboo Standalone for Windows (Windows Installer)

Note, if you wish to run Bamboo on a Windows x64 platform, make sure that you download the 64-bit version of Bamboo distribution.

1. Download Bamboo Standalone for Windows. Bamboo Standalone for Windows is available for download from the Bamboo Download Center. Choose the Windows Installer (.exe) download.
2. Launch the Bamboo Windows installer (atlassian-bamboo-x.x-standalone.exe) to begin the installation wizard.
3. 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:

     C:/Program Files/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:

     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 Standalone for Windows (ZIP Archive)

1. Download Bamboo Standalone for Windows. Bamboo Standalone 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).
2. Extract the files from the ZIP Archive (atlassian-bamboo-x.x-standalone.zip) 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).

3. 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 the Bamboo/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.
4. 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.

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.

1. 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.