Skip to main content

Configure BuildNinja Server

Set up the BuildNinja 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 Unified Installer​

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

    buildninja-unified-installer-overview

  2. Navigate to Installation Settings.

    build-ninja-server-installer-installation-settings-icon

  3. Check and provide the following details:

    • Installation Directory: Path where BuildNinja components are installed on your system. The default value is C:\BuildNinja.
    • 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.

    build-ninja-server-installer-installation-settings

  4. Click Save to save your installation settings.

    build-ninja-server-installer-installation-settings-save-button

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

    build-ninja-server-installer-install-button

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

    build-ninja-server-installer-installation-completed-message

    build-ninja-first-time-sign-in-page

Access BuildNinja Web Interface​

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

    build-ninja-first-time-sign-in-page

  2. Use the default administrator credentials to sign in:

    • Email: root
    • Password: root@123

    deafult-email-password-entered

  3. Click Sign in to continue.

    deafult-email-password

  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.

    change-password-filled

  5. Click Update Password to reset the password.

    update-password-button After successfully resetting your password, BuildNinja will automatically redirect you to the Dashboard dashboard-icon.