Step 1. Installation Settings 

When you launch Bamboo for the first time, you will need to provide some configuration information before you can start using it.


 

• 'Server ID' — This is generated automatically by Bamboo.
• 'License Key' — You are required to enter a valid license key before you can use Bamboo. You can generate your own Bamboo evaluation license from your Atlassian self-service account here. If you have any problems with this please email sales.
• 'Configuration Directory' — This is where Bamboo will store its configuration files.
• 'Build Data Directory' — This is where Bamboo will store its project data files.
• 'Build Working Directory' — This is where Bamboo will check out project files from source control.
  You may find it simplest to keep the default settings for the above three directories. For more information please see Locating Important Directories and Files.
• 'Broker URL' — This is 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, but can also be manually specified as a system property. The system property, if specified, will override the bamboo.cfg.xml property.

  tcp://localhost:54663

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

Step 2. Database

Here, you will choose what type of database Bamboo will use:

• 'Embedded Database' — choose this for quick and easy first-time installation of Bamboo.
  Note that the embedded HSQL database is suitable for evaluation purposes only. You should later move to an external database before deploying Bamboo in production, as described in Moving your Bamboo Data to a different Database.
  OR:
• 'External Database' — if you wish to use an external database, please see Connecting Bamboo to an external database.

Step 3. Starting Data

Here, you will tell Bamboo how to populate the 'home directory' that you setup when you installed Bamboo.

• 'Create new Bamboo home' — choose this if you are performing a normal installation or upgrade.
  OR:
• '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.

Step 4. Bamboo Administrator

Here, you will enter the details of the first registered user to the Bamboo system. This user will have global administrative privileges over the entire installation of Bamboo and should not be removed.

Step 5. Server Configuration

The final page of the Setup Wizard allows you to enter some final configuration data for Bamboo.

• 'Name' — for more details please see Specifying Bamboo's Title.
• 'Base URL' — for more details please see Specifying Bamboo's URL.
• 'Apply gzip compression to reduce the size of Bamboo's web pages?' — for more details please see Enabling GZIP Compression.
• 'Accept remote API calls?' — for more details please see Enabling Bamboo's Remote API. 

Once you have clicked "Complete Installation", the setup process is done and you are now at the Bamboo dashboard.

Next...

About Projects, Plans and Builds
Creating a Plan