Documentation for Bamboo 4.3.x. Documentation for other versions of Bamboo is available too.

Custom capabilities can be used to control which jobs will be built by a particular agent. For example, if the builds for a particular job should only run in a Windows environment, you could create a custom capability 'operating.system=WindowsXP' for the appropriate agent(s), and specify it as a requirement for this job. (See Configuring a job's requirements.) Shared capabilities are inherited by all applicable agents, that is, (shared) local server capabilities are inherited by all local agents, and shared remote capabilities are inherited by all remote agents. Note, however, that the value of a shared capability will be overridden by the value of an agent-specific capability of the same name (if one exists).

On this page:

Related pages:

Configuring a new local server custom capability

Before you begin:

To configure a new local server custom capability:

  1. Click Administration in the top navigation bar.
  2. Click Server Capabilities in the left navigation panel (under 'Build Resources').
  3. Locate the 'Add Capability' section at the bottom of the screen (see screenshot below).
  4. Choose Capability Type > Custom.
  5. Specify values for Key and Value.
  6. Click Add.

Configuring a new shared remote custom capability

To configure a new shared remote custom capability:

  1. Click Administration in the top navigation bar.
  2. Click Agents in the left navigation panel (under 'Build Resources').
  3. Locate the 'Remote Agents' section.
  4. Click Shared Remote Capabilities.
  5. Locate the 'Add Capability' section at the bottom of the screen (see screenshot below).
  6. Choose Capability Type > Custom.
  7. Specify values for Key and Value.
  8. Click Add.

Screenshot: Adding a shared custom capability


Log a request with our support team.


Raise an issue for our developers or tech writers.


See answers from the community.


Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.