Installing Bamboo on Windows

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

In this guide we'll run you through installing Bamboo with an external database on Windows.

On this page

 

Before you begin

Before you install Bamboo, there are a few questions you need to answer. 

Are you using a supported operating system?

Tell me more...

Check the Supported platforms page for the version of Bamboo you are installing. This will give you info on supported operating systems, databases and browsers.

Good to know:

  • We only support Bamboo on x86 and 64 bit x86 derived hardware platforms.
  • You will need permissions for both the Bamboo installation and home directories. 

Is your JAVA_HOME variable set correctly?

Tell me more...

Before you install Bamboo, check that you're running a supported Java version and that the JAVA_HOME environment variable is set correctly.

Bamboo can only run with the JDK (not JRE).

To check your Java version:

java -version

To check your JAVA_HOME variable is set correctly:

echo %JAVA_HOME%

If you see a path to your Java installation directory, the JAVA_Home environment variable has been set correctly. If a path is not returned you'll need to set your JAVA_HOME environment variable manually before installing Bamboo.


Install Bamboo

1. Download Bamboo 

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

It is highly recommended to avoid placing the Bamboo home directory in any Windows security controlled directory, for example, C:\Program Files, C:\Users, C:\Windows

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:

          C:\Users\<current-user>\Bamboo-home

          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 bamboo-init.properties 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:

        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.

      3. If you are going to use Bamboo remote agents, set the following in the bamboo-init.properties file in the <Bamboo installation directory>/atlassian-bamboo/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. Start Bamboo

a) In the command line, change the directory to <Bamboo installation directory> and run the command to start Bamboo:

$ cd <Bamboo installation directory>

$ bin\start-bamboo.bat

b) After successfully starting Bamboo, you will find it online at http://localhost:8085/

3. Configure Bamboo

You are starting Bamboo for the first time, so you will need to follow the Setup Wizard to configure Bamboo. See Running the Setup Wizard.

Start using Bamboo

That's it! Your Bamboo site is accessible from a URL like this: http://<computer_name_or_IP_address>:<port>

If you want your Bamboo instance always running, check how to run Bamboo as a service.

Troubleshooting

Running into problems installing Bamboo?

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.



Last modified on Aug 24, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.