Running the Setup Wizard

When you launch Bamboo for the first time, the Bamboo Setup Wizard will display. The Wizard will lead you through the Bamboo settings that you need to configure before you can start using it.

Before you begin

If you are currently using Atlassian's Crowd with Bamboo and wish to import existing data into Bamboo (see Step 5. Starting Data below), you will need to disable Crowd before starting the Setup Wizard. To do this, select Administration > Security > User directories.

You can then re-enable Crowd and restart Bamboo at the completion of the Setup Wizard.

Step 1. License Details and Setup Method

You must have a valid Bamboo license (evaluation or commercial) to use Bamboo. You can generate your own Bamboo evaluation license from your MyAtlassian self-service account here.

Once you have entered a valid license key, you can choose which setup method you prefer for your Bamboo installation:

  • Express installation — use this method if you are evaluating or demonstrating Bamboo.
    • The Express installation method requires only a minimum of configuration information. It sets up Bamboo with default settings and an embedded database (H2). 
    • If you choose the Express installation method you can skip to Step 6. Set Up Administrator User below.

Custom installation — use this method if you are setting up a production instance of Bamboo.

    • The Custom installation method takes longer, but allows you to configure Bamboo with an external database, customize the default settings, and/or initialize the server with your own data.
    • If you choose the Custom installation method, proceed to Step 2. General Configuration below.

Welcome to setup

Step 2. General Configuration

This step applies to the custom installation method only.

On this page you specify a number of Bamboo server settings, such as the address of the server, where data is stored and the message broker used to communicate with remote agents.

(warning) You may find it simplest to keep the default settings for the three directory settings in the table. For more information please see Locating important directories and files.

NameSee Specifying Bamboo's Title
Base URLSee Specifying Bamboo's URL
Configuration DirectoryThe location for Bamboo configuration files.
Build Data DirectoryThe location for Bamboo project data files.
Build Working DirectoryThe location of project files checked out from source control.
Broker URL

Only visible if you are permitted remote agents under your Bamboo license.

The URL of the embedded messaging broker that Bamboo sets up to communicate with its remote build agents. This URL will be written to bamboo.cfg.xml as a property. You can update this file if you want to change your Broker URL.

  • Replace localhost with the real host name or IP address of your Bamboo server. You should not use localhost as the host name in the Broker URL, as remote agents are provided with the Broker URL on startup and use it to communicate to the server.
  • If port number 54663 is already in use, specify a different port number.
Broker client URLThe URL used by agents to connect to the broker. This URL will be written to bamboo.cfg.xml as a property. You can update this file if you want to change your Broker URL. The default includes an actual IP of the Bamboo server. Specify if the default IP is not reachable from the agents.

General configuration

Step 3. Choose a Database Configuration

To resolve several security vulnerabilities, the JDBC driver for the H2 database engine is no longer bundled with Bamboo 9.2.8 and newer. If you want to evaluate Bamboo using the H2 database, see Connect Bamboo to an H2 database.

This step applies to the custom installation method only.

The database type is an important choice. If you select the H2 database, you don't have to configure the database connection details. However, the embedded H2 database is only suitable for evaluation purposes. You will need to move to an external database if you decide to deploy Bamboo in production at a later stage (as described in Move data to a different database).

Choose one of the following:

  • PostgreSQL
  • MySQL
  • Oracle
  • H2

If you select an external database like PostgreSQL or Oracle, proceed to step 4. If you select H2, skip to step 5.

Step 4. Database Configuration

This step applies to the custom installation method only.

If you selected an external database in step 3, you will need to provide the configuration details for your database. Please see Connect Bamboo to an external database for further instructions.

Database connection section

Step 5. Starting Data

This step applies to the custom installation method only.

On this page you specify how Bamboo will populate the home directory that you set up when you installed Bamboo.

Choose one of the following:

  • Create a new Bamboo home — choose this if you are performing a normal installation or upgrade.
  • Import existing data — only choose this under exceptional circumstances, e.g. if you are connecting Bamboo to a different database, or moving your pre-existing Bamboo installation to a different server. Avoid importing backups from different versions of Bamboo.

Starting data configuration

Step 6. Set Up Administrator User

The final step of the Setup Wizard is to enter the details of the first registered user for the Bamboo system. This user will have global administrative privileges over the entire installation of Bamboo and should not be removed.

Once you have entered the details for your administrator user, select Finish. The Bamboo dashboard will be displayed.

Congratulations, you have successfully set up Bamboo!

Last modified on Jan 4, 2024

Was this helpful?

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