Skip to main content

Configure Server and Agent on Windows

Install the BuildNinja Server and Agent on Windows using the unified installer or standalone binary files. The unified installer provides a guided setup experience and allows you to install:

  • Both the Server and the Agent
  • Only the Server
  • Only the Agent

By default, the installer also installs MongoDB locally if it is not already present on the system where the Server is being installed. If you provide a MongoDB URL that points to a remote MongoDB instance, the installer does not install MongoDB on either the local system or the remote host.

The installer also allows you to customize the installation directory, enabling you to choose a location that best fits your system layout or organizational standards.

Alternatively, using binary files offers greater control over installation parameters and environment configuration, making it suitable for advanced, customized, or automated setups.

Prerequisites:

Before installation, make sure to:

  • Check System RequirementsBuildNinja requires specific hardware, software, and infrastructure to deploy and run in a self-hosted environment. These requirements apply to the central server and the distributed build agents, ensuring a reliable, sc… and Supported Platforms and EnvironmentsBuildNinja supports various operating systems, environments, and tools for the CI/CD server and build agents. Conforming to these specifications ensures compatibility, scalability, and consistent performance across your ….
  • Download and install MongoDB database.
  • Obtain the BuildNinja unified installer or the required Server and Agent binary files.
note

Make sure to install the Agent after the Server is installed. The Agent requires the server URL to establish a connection during setup. Installing the Agent beforehand may cause connection issues.

Next Steps​