Creating a Local Agent

A Bamboo agent is a service that provides capabilities to run Job builds. There are two types of Bamboo agents:

local agents run as part of the Bamboo server.
remote agents are computers other than the Bamboo server that run the remote agent tool.
An elastic agent is a remote agent that runs in the Amazon Elastic Compute Cloud (EC2).

Local agents run in the server's process, i.e. in the same JVM as the server. Each remote agent runs in its own process, i.e. has its own JVM.)

On this page:

To create a new local agent:

Click the 'Administration' link in the top navigation bar.
Click the 'Agents' link in the left navigation column to display the Agents screen, which lists all Local and Remote Agents that currently exist in your Bamboo system.
Click the 'Add Local Agent' button. The Add Local Agent screen will be displayed (see screenshot below).
In the 'Name' field, type the name of the new agent. This name will be displayed on the Dashboard.
In the 'Description' field, type a description of the new agent. This description will only be shown to administrators.
Click the 'Add' button. This returns you to the Agents screen, specific to the agent you added, showing you details about your agent's capabilities, the Jobs it can build and its system properties. Note, new agents are enabled by default.
Your new local agent will inherit all local server capabilities that are defined in your Bamboo system. You can also define agent-specific capabilities (note that these will override shared capabilities) — see:

Your new agent will be able to run builds for all Jobs whose requirements are met by the agent's capabilities (see Configuring a Job's Requirements).

Screenshot above: Creating a local agent

Notes

One local agent, with the default name of 'Default Agent', is automatically created after installing Bamboo.