Installation

Installation

Kraken is a set of Bash scripts. There is nothing to compile and no package to install, you clone the repository and run the entry point. External tools are optional and only required by the modules that use them.

Prerequisites

Requirement	Why
Bash ≥ 4.0	mapfile, ${var,,}, namerefs and other modern features
coreutils / findutils	session handling and report aggregation
ping	connectivity test (test_connectivity)
sudo	only for raw-socket scans such as nmap SYN scans

Everything else degrades gracefully: if a tool is missing, the module prints a warning and skips that step.

Clone and run

git clone https://github.com/WhiteMuush/Kraken.git
cd Kraken
chmod +x kraken.sh
sudo ./kraken.sh

sudo is only needed if you intend to use scans that require raw sockets. For passive recon or web checks you can run it unprivileged.

Verify the install without launching the menu:

./kraken.sh --help
./kraken.sh --version      # Kraken Pentest Framework v1.2.0

Recommended external tools

Kraken wraps third-party tools. Install only the ones you need, see requirements.txt in the repository for the full list.

Tool	Used by	Install hint
dig (dnsutils / bind-tools)	Reconnaissance (preferred resolver)	apt install dnsutils
host, whois	Reconnaissance	apt install bind9-host whois
subfinder	Reconnaissance (subdomains)	go install github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
nmap	Port scanning	apt install nmap
curl	Web enumeration, vulnerability checks	apt install curl
openssl	Vulnerability assessment (TLS)	apt install openssl

Other tools listed in requirements.txt (amass, masscan, ffuf, gobuster, nuclei, …) are targets for future modules and are not yet wired into the menu.

Checking what Kraken can see

Launch Kraken and open the Configuration view (C in the main menu). It lists which tools are detected on PATH and which are missing, plus session and storage statistics. See Usage.

Updating

cd Kraken
git pull

Sessions are stored outside the repository tree by default (kraken_output/, gitignored), so updating never touches your results.