Configure BuildNinja Server

Set up the Server to manage builds, coordinate agents, and connect to the database. The server acts as the central controller for your CI/CD operations, handling build scheduling, monitoring, and communication between agents and projects.

Configure Server using Installers

1. Open the BuildNinjaServer.exe file to run the installer.

2. Navigate to Installation Settings.

   

3. Check and provide the following details:

   • MongoDB Url: Connection string or address of the MongoDB instance. You can verify the connection using the Test button.
   • Server Port: Port number used to run the server. You can test the port availability using the Test button. The default value is 8800.
   • Server DataBase Name: Name of the database used by the server. The default value is bn_server.

   

4. Click Save to save your installation settings.

   

5. Click Install to start the installation.

   

   After successful installation, an Installation Completed message appears, and the Sign-in page automatically opens in your default browser.

   

   

Configure Server using Binary Files

1. Define the environment variables that control server behavior, database connections, storage paths, and authentication settings. For details on supported variables and how to set them up, see Set Up on Windows.

   

2. Start the server by running the bn_server_windows.exe file included in the package. This launches the server in CLI mode. By default, it runs on port 8800, unless overridden using the BN_SERVER_PORT environment variable. Once started, the server automatically connects to the configured MongoDB instance using the URI and credentials defined in BN_SERVER_MONGOURI.

   note

   Make sure MongoDB is running and accessible at the specified URI before starting the server.

Access BuildNinja Web Interface

1. Open a browser and visit http://<your-server-ip>:8800/.

   

2. Use the default administrator credentials to sign in:

   • Email: root
   • Password: root@123

   

3. Click Sign in to continue.

   

4. After signing in, the "Sign-in" page will prompt you to reset the password. Enter the following details:

   • Current Password: The default administrator password.
   • New Password: Enter a strong password for your account, at least 8 characters with a combination of letters, numbers, and special characters.
   • Confirm New Password: Enter the password you have entered in the "New Password" field.

   

5. Click Update Password to reset the password.

   After successfully resetting your password, BuildNinja will automatically redirect you to the Dashboard .