EN KO

Install Noir

Hak
Noir is a single binary with no runtime dependencies. Homebrew is the quickest way for most users, but pick whatever fits your system.

Homebrew (macOS and Linux)

The easiest option. Noir has an official Homebrew formula, so brew upgrade keeps it up to date too.

brew install noir

Shell completions for Zsh, Bash, and Fish are automatically installed.

Snapcraft (Linux)

Snap packages work across most Linux distros and auto-update in the background.

sudo snap install noir

Docker

Handy when you don't want to install anything on the host, or need Noir inside a CI/CD pipeline.

docker pull ghcr.io/owasp-noir/noir:latest

Scan the current directory:

docker run --rm -v $(pwd):/tmp ghcr.io/owasp-noir/noir:latest -b /tmp

All available tags are on the GitHub Packages page.

Nix

If you use Nix, install via Flakes:

nix profile add github:owasp-noir/noir

**Tip:** In Docker or restricted environments, you may need to enable experimental features. Use the command below.

nix --extra-experimental-features "nix-command flakes" profile add github:owasp-noir/noir

Or run once without installing:

nix run github:owasp-noir/noir -- -h

Direct Binary Download

No package manager? Grab a prebuilt binary from GitHub Releases. Linux and macOS builds are provided.

  1. Download the archive for your platform (e.g., noir-linux-x86_64.tar.gz or noir-macos-universal.tar.gz).

  2. Extract:

    tar xzf noir-*.tar.gz

  3. Move to a directory on your PATH:

    sudo mv noir /usr/local/bin/

  4. Verify:

    noir --version

Debian Package (.deb)

Debian/Ubuntu users can use the .deb package from GitHub Releases. It integrates with dpkg/apt like any other system package.

  1. Download the .deb package:

    wget https://github.com/owasp-noir/noir/releases/latest/download/noir_latest_amd64.deb

  2. Install:

    sudo dpkg -i noir_latest_amd64.deb

  3. Fix missing dependencies if needed:

    sudo apt-get -f install

  4. Verify:

    noir --version

Unofficial

Arch AUR

Noir is in the AUR. Use your preferred helper:

yay -S noir

Build from Source

For custom builds or contributing back to the project.

Requires [Crystal](https://crystal-lang.org/install/) programming language installed.

  1. Clone the repository:

    git clone https://github.com/owasp-noir/noir
cd noir

  2. Install dependencies:

    shards install

  3. Build:

    shards build --release

    The compiled binary is at ./bin/noir.

Verify Your Installation

Whichever method you chose, confirm Noir is installed:

noir --version

If you see a version number, you're ready.

Next: Your First Scan

Esc