mirror of https://github.com/hashcat/hashcat.git synced 2025-07-22 22:48:47 +00:00

Gabriele Gristina 27d6816e09

graphic improvement

2025-06-07 13:21:31 +02:00

3.4 KiB

Raw Blame History

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 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! 😎

3.4 KiB Raw Blame History Unescape Escape