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.

Every method below installs the same noir binary, so you only need one. They're ordered roughly easiest-first — find the row that matches your platform and package manager, and skip the rest.

Homebrew (macOS and Linux)

The easiest option. Noir has an official Homebrew formula.

To install:

brew install noir

To update:

brew upgrade 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.

To install:

sudo snap install noir

To update manually:

sudo snap refresh noir

Docker

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

To pull/update the latest image:

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

Image tags follow the OCI/Docker convention without the v prefix, e.g. :0.30.0, :0.30, and :latest. (Versions up to v0.29.1 used the :vX.Y.Z form; update any pinned references.) All available tags are on the GitHub Packages page.

Nix

If you use Nix, install via Flakes.

To install:

nix profile add github:owasp-noir/noir

To update:

nix profile upgrade 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.

To install or update:

  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 or overwrite the existing binary in 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. Both amd64 and arm64 are provided.

To install or update:

  1. Resolve the latest version and download:

    VERSION=$(curl -s https://api.github.com/repos/owasp-noir/noir/releases/latest | grep '"tag_name":' | sed -E 's/.*"v([^"]+)".*/\1/')
wget "https://github.com/owasp-noir/noir/releases/download/v${VERSION}/noir_${VERSION}_amd64.deb"

  2. Install or upgrade:

    sudo dpkg -i "noir_${VERSION}_amd64.deb"

  3. Fix missing dependencies if needed:

    sudo apt-get -f install

  4. Verify:

    noir --version

Arch Linux (AUR)

Noir is officially published on the AUR.

To install or update:

yay -S noir

RPM Package (.rpm)

Fedora, RHEL, CentOS, openSUSE, and other RPM-based distros can use the .rpm package from GitHub Releases. Both x86_64 and aarch64 are provided.

To install:

  1. Resolve the latest version and download:

    VERSION=$(curl -s https://api.github.com/repos/owasp-noir/noir/releases/latest | grep '"tag_name":' | sed -E 's/.*"v([^"]+)".*/\1/')
wget "https://github.com/owasp-noir/noir/releases/download/v${VERSION}/noir-${VERSION}.x86_64.rpm"

  2. Install:

    sudo rpm -i "noir-${VERSION}.x86_64.rpm"

    Or with dnf:

    sudo dnf install "./noir-${VERSION}.x86_64.rpm"

To update:

  1. Download the latest version as shown in the install step.

  2. Upgrade:

    sudo rpm -U "noir-${VERSION}.x86_64.rpm"

    Or with dnf:

    sudo dnf upgrade "./noir-${VERSION}.x86_64.rpm"

  3. Verify:

    noir --version

Alpine Package (.apk)

Alpine Linux users can use the .apk package from GitHub Releases. Both x86_64 and aarch64 are provided.

To install or update:

  1. Resolve the latest version and download:

    VERSION=$(curl -s https://api.github.com/repos/owasp-noir/noir/releases/latest | grep '"tag_name":' | sed -E 's/.*"v([^"]+)".*/\1/')
wget "https://github.com/owasp-noir/noir/releases/download/v${VERSION}/noir-${VERSION}-x86_64.apk"

  2. Install or upgrade:

    sudo apk add --upgrade --allow-untrusted "noir-${VERSION}-x86_64.apk"

  3. Verify:

    noir --version

Build from Source

For custom builds or contributing back to the project.

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

To install:

  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.

To update:

  1. Pull latest changes:

    git pull

  2. Install dependencies and rebuild:

    shards install
shards build --release

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