kali-wsl2-pentest-setup

Provisions a Kali Linux WSL2 penetration testing environment on Windows with verified tool installation.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill kali-wsl2-pentest-setup-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kali-wsl2-pentest-setup
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/security/kali-wsl2-pentest-setup
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill kali-wsl2-pentest-setup-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a complete Kali Linux penetration testing toolkit on Windows via WSL2 is error-prone: failed installs leave stale VHDX files, apt caches report missing packages, Metasploit's database initializes empty, and several tools are absent from minimal Kali snapshots. This Skill walks through the entire provisioning process with fixes for each known failure. ## Core Features & Use Cases - Batched Tool Installation: Installs the standard offensive-security toolset (nmap, metasploit, nuclei, sqlmap, hashcat, burpsuite, and more) in isolated apt batches to avoid disk I/O failures. - Failure Recovery Recipes: Provides verified fixes for stale VHDX reclamation, "unable to locate package" errors, and the empty Metasploit database.yml problem. - Source Builds for Missing Packages: Covers pip/git/Go installation paths for tools not in minimal Kali (shodan, droopescan, evilginx2, king-phisher). - Use Case: A user on a Windows 11 machine asks to build an ethical hacking lab for testing their own network; the Skill provisions Kali-WSL2, installs and verifies 40+ tools, fixes the Metasploit DB, and drops helper scripts (scope.sh, recon.sh, vulnscan.sh) into /opt/pentest/bin. ## Quick Start Set up a Kali Linux WSL2 pentest environment on my Windows PC with the standard tools for testing systems I own.

Frequently Asked Questions about kali-wsl2-pentest-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install Kali Linux pentest tools on Windows with WSL2?▼

Run wsl --install --distribution kali-linux --no-launch, then apt-get update before installing tools in batches (recon, web, password, exploit, wireless, forensics). Verify each binary with --version after installation completes.

Why does apt say unable to locate package on a fresh Kali install?▼

A fresh Kali snapshot has a stale package cache, so apt reports existing packages as missing. Run apt-get update first, then re-run the install. Some tools like shodan and droopescan require pip3 install --break-system-packages instead.

How do I fix Metasploit db_status showing no connection?▼

msfdb init often creates an empty database.yml on fresh Kali. Start the postgres cluster, create the msf role and database manually, write a proper database.yml with credentials, then verify with msfconsole -q -x 'db_status; exit'.

Can aircrack-ng and wifite work inside WSL2?▼

No. WSL2's Microsoft kernel has no wireless extensions or USB passthrough, so aircrack-ng, wifite, and reaver cannot see physical WiFi adapters. Real wireless attacks require native Linux with a USB adapter like the Alfa AWUS036ACM.

Why does Kali WSL2 installation fail with Input/output error?▼

This usually means insufficient disk space on C: or a stale VHDX (~13 GB) left by a prior failed install. Reclaim space with powercfg /hibernate off, clear Temp files, and run wsl --unregister kali-linux before reinstalling.

Is it legal to use these penetration testing tools?▼

Only against systems you own or have written authorization to test. The Skill enforces an ethical gate requiring an authorized scope file before any active scan, and stress-testing tools are restricted to your own services.