Installation

Homebrew (macOS and Linux)

brew install noir

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

Snapcraft (Linux)

sudo snap install noir

Docker

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

All available tags are on the GitHub Packages page.

Nix

nix profile add github:owasp-noir/noir

{% alert_info() %} Tip: In Docker or restricted environments, you may need to enable experimental features:

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

{% end %}

Or run directly without installing:

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

Direct Binary Download

Download prebuilt binaries from the GitHub Releases page.

  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)

For Debian/Ubuntu and derivatives, use the .deb package from the GitHub Releases page.

  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

yay -S noir

Build from Source

Requires Crystal 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 --no-debug
    

    The compiled binary is at ./bin/noir.

Esc