Installing Bamboo on Windows

This page describes how to install Atlassian Bamboo on Windows.

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. サポート対象プラットフォームを確認する

Better check the Supported platforms page first; it lists the application servers, databases, operating systems, web browsers and JDKs that we have tested Bamboo with and recommend.

 Note that Atlassian currently only supports Bamboo on x86 and 64-bit x86 derived hardware platforms.

2. Java のバージョンを確認する

In a command prompt, run this command:

java -version

The version of Java should be 1.8.x. Note that Bamboo requires the Java JDK to work, not the Java JRE.

If you don't see a supported version, then get Java...

Java をインストール

Download and install the Java Platform JDK (not the JRE) from Oracle's website.

Now try running 'java -version' again in a new command promptto check the installation. The version of Java should be 1.8.x.

3. Check that Windows can find Java  

Bamboo uses the JAVA_HOME environment variable to find Java. To check that, in a command prompt, run: 

echo %JAVA_HOME%

You should see a path to the root directory of the Java installation. When running Bamboo on Windows, unlike Linux or Unix, JAVA_HOME paths with spaces are just fine. 

If you don't see a path...

If you don't see a path, or if you just see %JAVA_HOME%, then set JAVA_HOME as follows:

Windows 7 の場合:

  1. [Start] に移動し、"sys env" を検索してから、[Edit the system environment variables] を選択します。
  2. [Environment Variables] をクリックした後、[System variables] の下で [New] をクリックします。
  3. Enter "JAVA_HOME" as the Variable name, and the absolute path to where you installed Java as the Variable value. Don't use a trailing backslash, and don't wrap the value in quotes.

Now, in a new command prompt,  try running '%JAVA_HOME%\bin\java -version'. You should see the same version of Java as you saw in 2. above.

4. Check permissions

Check your system permissions. You will need to have permissions for both the Bamboo installation and home directories.

5. Download Bamboo 

Download Bamboo from the Atlassian download site. You can choose either the Windows Installer version (.exe) or a ZIP Archive (.zip).

Installing using the Windows Installer

  1. Launch the Bamboo Windows installer to begin the installation wizard.
  2. The installer requires you to specify two directories:
    • Destination 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:

Ensure that the Bamboo home directory is not located inside the <Bamboo installation directory>.

Installing using the Zip archive

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

  2. 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 in the <Bamboo installation directory>/atlassian-bamboo/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:


    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.

  3. If you are going to use Bamboo remote agents, set the following in the file in the <Bamboo installation directory>/atlassian-bamboo/WEB-INF/classes directory:
    • 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.

6. Start Bamboo!

In a terminal, change directory to <Bamboo installation directory> and run this command:


Access your running Bamboo instance by going to your web browser and entering the address: http://localhost:8085/.

7. Configure Bamboo

Configure Bamboo using the Setup Wizard that is displayed. Read Running the Setup Wizard for further instructions.

8. Running Bamboo as a service

If you want to run Bamboo as a service, then please consult Running Bamboo as a service.


If something is not working correctly after you have completed the steps above to install Bamboo, please check for known Bamboo issues and try troubleshooting your upgrade as described below:

  • Check for known issues. Sometimes we find out about a problem with the latest version of Bamboo after we have released the software. In such cases we publish information about the known issues in the Bamboo Knowledge Base. Please check the known issues in the Bamboo Knowledge Base and follow the instructions to apply any necessary patches if necessary.
  • Did you encounter a problem during the Bamboo installation? Please refer to the guide to troubleshooting upgrades in the Bamboo Knowledge Base.
  • If you encounter a problem during the upgrade and cannot solve it, please create a support ticket and one of our support engineers will help you.

最終更新日 2016 年 5 月 24 日


Powered by Confluence and Scroll Viewport.