Skip to content

BUILD.md

Latest commit

 

History

History
143 lines (91 loc) · 3.53 KB

BUILD.md

File metadata and controls

143 lines (91 loc) · 3.53 KB

Hashcat – Build Documentation

Revision: 1.7
Author: See docs/credits.txt

✅ Requirements

  • Python 3.12 or higher

Check your Python version:

$ python3 --version
# Expected output: Python 3.13.3

If you can't install Python ≥ 3.12 globally, you can use pyenv.

If you're using pyenv, follow all steps below. Otherwise, follow only steps 3 and 5.

🛠️ Building Hashcat – Step-by-Step

🔹 Step 1: Install dependencies and pyenv

On Linux

Install required libraries to build Python:

$ sudo apt install libbz2-dev libssl-dev libncurses5-dev libffi-dev libreadline-dev libsqlite3-dev liblzma-dev

Install pyenv:

$ curl https://pyenv.run | bash

Follow the instructions shown after installation to set up your shell correctly.

On macOS

Install pyenv via Homebrew:

$ brew install pyenv

🔹 Step 2: Install Python using pyenv

Install Python 3.12 (or newer):

$ pyenv install 3.12

Check installed versions:

$ pyenv versions
# Example:
# * system
#   3.12.11

🔹 Step 3: Clone the Hashcat repository

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

🔹 Step 4: Set the local Python version

$ pyenv local 3.12.11

🔹 Step 5: Build Hashcat

$ make clean && make

🔹 Step 6 (Optional): Install Hashcat (Linux only)

$ make install

Hashcat will use the following locations depending on your environment:

Condition Session Files Kernel Cache Potfiles
$HOME/.hashcat exists $HOME/.hashcat/sessions/ $HOME/.hashcat/kernels/ $HOME/.hashcat/
$XDG_DATA_HOME and $XDG_CACHE_HOME set $XDG_DATA_HOME/hashcat/sessions/ $XDG_CACHE_HOME/hashcat/kernels/ $XDG_DATA_HOME/hashcat/
Only $XDG_DATA_HOME set $XDG_DATA_HOME/hashcat/sessions/ $HOME/.cache/hashcat/ $XDG_DATA_HOME/hashcat/
Only $XDG_CACHE_HOME set $HOME/.local/share/hashcat/sessions/ $XDG_CACHE_HOME/hashcat/kernels/ $HOME/.local/share/hashcat/
None of the above $HOME/.local/share/hashcat/sessions/ $HOME/.cache/hashcat/ $HOME/.local/share/hashcat/

🔥 Building Hashcat for Android

See: BUILD_Android.md

🐳 Building Hashcat with Docker

See: BUILD_Docker.md

🪟 Building Hashcat for Windows

Method Documentation
From macOS BUILD_macOS.md
Using Windows Subsystem for Linux (WSL) BUILD_WSL.md
Using Cygwin BUILD_CYGWIN.md
Using MSYS2 BUILD_MSYS2.md
From Linux Run: make win

🎉 Done

Enjoy your fresh Hashcat binaries! 😎