# Ninja

Ninja is a small, fast build system that compiles software. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5346/ninja

## Description

Ninja is a small, fast build system that compiles software. It coordinates the many steps needed to turn source code into a finished application, running tasks in parallel to keep build times short. Developers and CI/CD pipelines use it as a lighter, quicker alternative to build tools like CMake and GNU Make.

## Platform availability

Available on 0 of 10 platforms.

## Health score

74/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 18 days ago)
- Popular: 83 (13,366 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Light to run: 60 (2 GB minimum RAM, runs on ARM)
- Security check: 73 (no serious findings, 1 minor, CI, tests, OpenSSF Scorecard 4.8/10)

## Links

- GitHub: https://github.com/ninja-build/ninja
- Docker Hub: https://hub.docker.com/r/zhuxindong/ninja
- Official website: https://ninja-build.org/

## Common questions

### Do I need to install Ninja system-wide to use it?

No, the only required file is the resulting ninja binary. Prebuilt binaries for Linux, Mac, and Windows are available from GitHub releases.

### How do I add Bash completion or editor modes?

Copy some files from the misc/ directory to the appropriate locations. This enables Bash completion and Emacs/Vim editing modes, but it is optional.

### How can I build Ninja from source?

You can run ./configure.py --bootstrap to generate a ninja binary and a build.ninja file, then build Ninja with itself. Alternatively, use CMake with -DBUILD_TESTING=OFF to build only the ninja binary.

### How can I build and run Ninja’s unit tests?

With the Python bootstrap, pass --gtest-source-dir=PATH to a GoogleTest source directory, then run ./ninja_test after building. With CMake, omit -DBUILD_TESTING=OFF, build, and run build-cmake/ninja_test.

### How do I generate the Ninja manual locally?

For HTML, put asciidoc and xsltproc in PATH and run ./configure.py ninja manual doc/manual.html. For PDF, put dblatext in PATH, run configure.py if needed, and then ninja doc/manual.pdf.

## Alternatives

- CMake
- GNU Make

---
Source: Our Local Host (https://ourlocalhost.com/app/5346/ninja), the self-hosted and open-source app directory.
