Windows
Install the server, agent, or both. The unified installer can include local MongoDB.
Installer 2026.1.2.1
Your infrastructure.
Your first build.
Set up the server, connect an agent, and bring your repository into the workflow.
CURRENT PUBLISHED DOWNLOADS
Released 17 August 2026Choose your environment.
Linux
Configure the packages and MongoDB for the environment you manage.
Server 1.2.0Agent 1.2.0
Read the setup guidemacOS
Use the server and agent packages for your Mac environment. Configure MongoDB separately.
Server 1.2.0Agent 1.2.0
Read the setup guidePackage downloads open the existing BuildNinja download flow. Check its current release notes and architecture before installing.
Prefer containers?
Pull the official images, then follow the Docker guide to configure the database, storage, networking, and startup.
Open installation guidesBuildNinja Server
docker pull grapehub/buildninja-server:latestBuildNinja Agent
docker pull grapehub/buildninja-agent:latestPLAN YOUR ENVIRONMENT
Leave room for the work you build.
The server and agent have different jobs. Size them for your repositories, tools, concurrent builds, and artifacts.
| Component | CPU baseline | Memory baseline | Starting storage allowance |
|---|---|---|---|
| Server | 2+ cores | 4 GB | 20 GB |
| Build agent | 2+ cores | 2 GB | 10 GB |
These are planning baselines, with storage headroom above the current download page minimums. Build tools, database growth, checkouts, and artifacts need additional capacity. Follow the requirements for your selected release.
MongoDB
Included through the Windows unified setup; configure it separately for Linux, macOS, or container deployments.
Build tools
Install the SDKs, runtimes, shells, and utilities required by your steps on the selected agents.
Network access
Ensure the server, database, agents, and repositories can communicate as required by the setup guide.
FROM SETUP TO A WORKING BUILD
Connect. Configure. Run.
01
Prepare an agent
Connect and authorize a machine with the tools and access your build needs.
02
Create a configuration
Connect the repository, add execution steps, and choose triggers and agent criteria.
03
Inspect the result
Open Build Results to review logs, changes, and artifacts.
kenzoAI is coming soon.
We’re preparing build intelligence for a future release. The core BuildNinja workflow is available now: install the platform, connect your repository, and run your first build.
