Manage Agents

Agents are the individuals who execute your CI/CD jobs, build scripts, and deploy tasks. This section will teach you how to edit agent configurations and manage, monitor, and scale agents to ensure builds run efficiently and securely. Proper agent management improves performance, supports multiple environments, and maintains control over the build infrastructure.

BuildNinja allows you to manage build agents directly from the user interface. You can authorize newly registered agents, enable or disable agents, refresh agent details, reset or delete agents, and filter the agent list by operating system or status to simplify navigation and administration.

note

Only administrators can authorize, enable, disable, or delete agents.

📄️ Authorize Agent

When a new agent first registers with the BuildNinja server, it appears in the Agents interface in an unauthorized state. To authorize a newly registered agent:

📄️ Refresh Agent

You can refresh an agent to update its system properties and environment configuration. This is particularly useful after OS-level changes or adjustments to BuildNinja settings. To refresh an agent:

📄️ Disable or Enable Agent

You can temporarily disable an agent to prevent it from accepting new builds without removing it from the system.

📄️ Reset Agent

Reset allows you to clear the agent’s state and reinitialize its connection with the server. This is useful when troubleshooting, recovering from configuration issues, or preparing the agent for redeployment. To refresh an agent:

📄️ Delete Agent

Delete allows you to remove the agent from the BuildNinja server permanently. This action is useful when an agent is decommissioned, no longer required, or being replaced. Once deleted, the agent must be re-registered to connect again. To delete an agent:

📄️ Filter Agents by OS and Status

The Agents agents-icon management interface includes filters to help you quickly locate specific agents and manage large or heterogeneous agent pools efficiently based on: