TeamCity On-Premises
 
Get TeamCity On-Premises

Agent Requirements

Edit pageLast modified: 21 January 2025

Agent requirements are special conditions that define whether a build configuration can run on a particular build agent. Together with grouping by agent pools, they give you a flexible control over how builds are distributed to agents.

To create an explicit agent requirement for a given build configuration:

  1. Navigate to Administration | <Your Configuration> to access build configuration settings.

  2. Open the Agent Requirements settings tab.

  3. Click Add new requirement. Each requirement represents a conditional rule for a certain parameter. While you are entering a parameter name or value, TeamCity will show you related suggestions.

To temporarily disable or delete a requirement, use its context menu.