Installing Bamboo on Windows
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?
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?
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:
To check your JAVA_HOME variable is set correctly:
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.
1. Download Bamboo
Download Bamboo from the Atlassian download site. You can choose either the Windows Installer versions (
.exe) or the ZIP Archive (
It is highly recommended to avoid placing the Bamboo home directory in any Windows security controlled directory, for example,
- Launch the Bamboo Windows installer to begin the installation wizard.
- 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:
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>.
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 installation directory>/atlassian-bamboo/WEB-INF/classes/
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.propertiesfile in the
<Bamboo installation directory>/atlassian-bamboo/WEB-INF/classesdirectory:
- 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>
b) After successfully starting Bamboo, you will find it online at
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.
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.