Skip to content

BUILD_MSYS2.md

Latest commit

 

History

History
108 lines (72 loc) · 2.02 KB

BUILD_MSYS2.md

File metadata and controls

108 lines (72 loc) · 2.02 KB

Compiling hashcat with MSYS2

Tested on Windows 11 23H2 x64

Prerequisites

  1. Install MSYS2 from the official website and follow steps 1–7.

  2. Open the MSYS2 MINGW64 terminal Do not use the plain MSYS or UCRT terminals.

  3. Update the base system:

    pacman -Syu

    If prompted to close the terminal after core updates, do so, then reopen MINGW64 and run:

    pacman -Syu

  4. Install build dependencies:

    export _GW="mingw-w64-x86_64"
pacman -S --needed git make gcc libiconv-devel python3 $_GW-clang $_GW-rustup $_GW-toolchain $_GW-llvm $_GW-lld

  5. Ensure MinGW toolchain is first on PATH for this session:

    export PATH="/mingw64/bin:$PATH"

  6. Set up Rust:

    rustup default stable && rustup target add x86_64-pc-windows-gnu

Build

  1. Fetch the latest hashcat source code from GitHub:

    git clone https://github.com/hashcat/hashcat.git ~/hashcat
cd $_

  2. Compile:

    make -j"$(nproc)" WIN_PYTHON=""

    Upstream uses make WIN_PYTHON=""; the -j$(nproc) just speeds things up.

    To rebuild cleanly later, use:

    make clean && make -j"$(nproc)" WIN_PYTHON=""

Running

Running inside MSYS2

./hashcat.exe

Running outside the MSYS2 shell (portable setup)

Copy the dependent DLLs next to hashcat.exe. Two common ones are:

  • msys-iconv-2.dll
  • msys-2.0.dll

(these can be found in msys64/usr/bin)

To verify which dependencies are missing:

Option A: ldd

ldd ./hashcat.exe

Option B: ntldd

pacman -S --needed mingw-w64-x86_64-ntldd
ntldd -R ./hashcat.exe

ntldd -R recursively shows transitive DLLs; copy anything not in C:\Windows\System32 to the same folder as hashcat.exe.

Post-build sanity check

To confirm GPU/OpenCL devices are detected:

./hashcat.exe -I

If your GPUs appear here, your build is good to go.