Agents and capabilities

A Bamboo agent is a service that can run job builds. There are two types of Bamboo agents:

(info) Local agents run in the Bamboo 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.


 A capability is a feature of an agent. A capability can be defined on an agent for:

  • an executable (e.g. Maven)
  • a JDK
  • a Version Control System client application (e.g. Git)
  • a custom capability. This is a key-value property which defines a particular characteristic of an agent (e.g. 'operating.system=WindowsXP' or 'fast.builds=true').

Capabilities typically define the path to an executable that has already been installed, and must be defined in Bamboo before Bamboo or its agents can make use of those.

Capabilities can be defined specifically for an agent, or they can be shared between either all local agents or all remote agents. Note that the value of an agent-specific capability overrides the value of a shared capability of the same name (if one exists).

See Configuring capabilities for more information.

Bamboo matches job requirements against agent requirements when allocating jobs to agents.

Viewing an agent

To view an agent, including the agent properties, capabilities and the plans that an agent can build, see Viewing a Bamboo agent's details.

Viewing the status of all agents

To view the status of all of your agents, see Monitoring agent status.

Viewing the agents and plans related to a capability

To view the agents and plans related to a capability, see Viewing a capability's agents and jobs.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport