Configure BuildNinja Agent

Set up the BuildNinja Agent to connect with the server, execute assigned build jobs, and report results. The agent acts as the execution node in the CI/CD process, running builds, tests, and deployment tasks as configured by the server.

note

You can install the Agent on the same machine as the BuildNinja Server or on a separate machine. The installation process is identical in both cases. When installing the Agent on a different machine, ensure that the Server URL is set to the address of the machine where the BuildNinja Server is running and that the server is accessible over the network.

Configure Agent using Unified Installer

1. Run the unified installer and select Agent as the component to install.

   

2. Navigate to Installation Settings.

   

3. Check and update the following details as needed:

   • Installation Directory: Path where BuildNinja components are installed on your system. The default value is C:\BuildNinja.
   • Agent Name: Name used to identify the agent. The default value is System-NameBuildNinjaAgent.
   • Agent Port: Port number used by the agent. The default value is 9500.
   • Server Url: Address of the BuildNinja Server. The default value is http://127.0.0.1.

   

4. Click Save to save your installation settings.

   

5. Accept the License Agreement and click Install to start installing the application.

   

   After successful installation, an Installation Completed message appears, and the agent automatically attempts to register itself with the server using the provided details. If the registration is successful, the server UI displays the agent in the Agents section.

   

   

   info

   For instructions on authorizing the agent, see Authorize AgentWhen 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: 1..