Agent States

Each agent has a status that indicates the current state of the agent. The status is visible in the Agents Section of the user interface. Possible states are described below:

State	Description
awaiting ping	The agent is online and has just completed executing a recipe. The master is awaiting the next ping result from the agent to determine its new state. This state allows agents to be shut down or rebooted in post-build hooks
building	The agent is online and currently executing a recipe.
building invalid	The agent is online and currently executing a recipe, but the master does not expect it to be. The master will request that the agent terminate the rogue recipe.
disable on idle	The agent is currently online and executing a recipe, but is marked to be disabled when the recipe completes.
disabled	The agent has been disabled and will be unavailable until it is enabled.
idle	The agent is online and available to execute a recipe.
initial	The master is awaiting an initial ping response for the agent.
offline	The agent is enabled but uncontactable, and thus unavailable for recipe execution.
post recipe	The agent is online and has just completed executing a recipe. The master is busy executing post-recipe actions for the agent such as downloading recipe output artifacts.
recipe assigned	The agent is online and the master has assigned a recipe to it. The master is awaiting the next ping from the agent confirming that it has started executing the recipe.
token mismatch	The agent security token does not match the master security token (see Agent Security for details). The agent will be unavailable until the mismatch is rectified.
version mismatch	The agent version does not match the master version. The agent will be unavailable until updated to the same version as the master.