AdhiHub WSL Setup

One command to set up WSL2 + your full dev environment on Windows.

---

Requirements & Support

Requirement	Details
OS	Windows 10 (build 19041+) or Windows 11
PowerShell	Version 5.1 or higher
Admin rights	Must run PowerShell as Administrator — scripts auto-restart with admin if not
Execution Policy	Run Set-ExecutionPolicy Bypass -Scope Process if you get a security error
Virtualization	Must be enabled in BIOS (the tool checks this)
Internet	Required to download tools and packages

How to Run

1. Open PowerShell as Administrator (right-click → Run as Administrator)
2. Paste the one-liner below and press Enter
3. Let the script do the rest

If you get a security error, run this first: Set-ExecutionPolicy Bypass -Scope Process

---

Available Scripts (in order)

Run any script independently — each does one thing and nothing else.

1. check-system.ps1 — Check if your PC is ready

Scans: OS version, PowerShell version, admin rights, virtualization, RAM, disk space, internet, WSL, winget. Tells you what passes and what needs fixing before you run anything else.

iwr -useb 'https://raw.githubusercontent.com/AdhiHub/WSL-Setup/main/check-system.ps1' | iex

2. wsl-only.ps1 — Install WSL2 + Linux distro

Enables WSL2, lets you pick a distro (Ubuntu, Kali, Debian, Alpine, Fedora, openSUSE). Nothing else.

iwr -useb 'https://raw.githubusercontent.com/AdhiHub/WSL-Setup/main/wsl-only.ps1' | iex

3. dev-tools.ps1 — Install 15 dev/system tools

Installs only what's missing: Git, VS Code, Node.js, Python, GitHub CLI, Docker Desktop, Postman, Windows Terminal, PowerShell 7, 7-Zip, FFmpeg, curl, wget, PowerToys, Oh-My-Posh.

iwr -useb 'https://raw.githubusercontent.com/AdhiHub/WSL-Setup/main/dev-tools.ps1' | iex

4. beautify-only.ps1 — Oh-My-Posh + Terminal Icons

Makes your PowerShell prompt beautiful with Oh-My-Posh and file icons. Nothing else.

iwr -useb 'https://raw.githubusercontent.com/AdhiHub/WSL-Setup/main/beautify-only.ps1' | iex

5. cyber-tools.ps1 — Install 24 pentesting tools (in WSL)

Installs inside WSL: nmap, masscan, sqlmap, nikto, gobuster, dirb, ffuf, wpscan, whatweb, hashcat, john, hydra, theHarvester, recon-ng, sherlock, metasploit-framework, searchsploit, responder, enum4linux, smbclient, impacket-scripts, netcat-openbsd, tcpdump, aircrack-ng.

iwr -useb 'https://raw.githubusercontent.com/AdhiHub/WSL-Setup/main/cyber-tools.ps1' | iex

6. full-setup.ps1 — Everything at once

Chains: System check → WSL2 → Dev tools → Beautify → Post-setup guide. Run this if you want it all automated.

iex ((New-Object Net.WebClient).DownloadString('https://raw.githubusercontent.com/AdhiHub/WSL-Setup/main/full-setup.ps1'))

7. install.ps1 / AdhiHub.ps1 — Menu-driven tool

Opens the interactive menu where you can pick any option: system scan, WSL, tools, cyber tools, Docker, optimization, beautify, or run all.

iex ((New-Object Net.WebClient).DownloadString('https://raw.githubusercontent.com/AdhiHub/WSL-Setup/main/install.ps1'))

---

Menu Tool Features

#	Feature	What it does
1	System Report	Full hardware scan (CPU, RAM, disk, virtualization, OS build, WSL status, all 15 tools)
2	Install Tools	Auto-detects what's installed, installs only what's missing
3	WSL Setup	Enables WSL2, installs any Linux distro (Ubuntu, Kali, Debian, Alpine, Fedora, openSUSE)
4	Cyber Tools	Install 24 pentesting tools inside WSL
5	Docker + WSL	Installs Docker Desktop, guides WSL2 integration setup
6	Optimization	Clean temp files, SFC scan, DISM repair, WSL disk shrink
7	Beautify	Oh-My-Posh prompt + Terminal-Icons for a beautiful PowerShell
8	Run ALL + Post-Setup Guide	Full auto setup — then shows what to do next

---

Tool Details

15 Dev/System Tools (Windows)

Git VS Code Node.js LTS Python 3 GitHub CLI (gh) Docker Desktop Postman Windows Terminal PowerShell 7 7-Zip FFmpeg curl wget PowerToys Oh-My-Posh

24 Cyber Tools (WSL)

Category	Tools
Scanner	nmap masscan
Web	sqlmap nikto gobuster dirb ffuf wpscan whatweb
Cracking	hashcat john hydra
OSINT	theHarvester recon-ng sherlock
Exploit	metasploit-framework searchsploit (exploitdb)
Network	responder enum4linux smbclient impacket-scripts netcat-openbsd tcpdump
Wireless	aircrack-ng

---

If You Get Error 429 (Too Many Requests)

Try this instead (bypasses rate limit):

iex (curl -s 'https://raw.githubusercontent.com/AdhiHub/WSL-Setup/main/AdhiHub.ps1' | Out-String)

Or download manually:

1. Go to https://github.com/AdhiHub/WSL-Setup
2. Click any .ps1 file → Raw → Save as .ps1
3. Right-click → Run with PowerShell

---

After Setup

# Update everything
winget upgrade --all
wsl --update
wsl --shutdown

# See your distros
wsl -l -v

# Enter a distro
wsl -d Ubuntu
wsl -d kali-linux

---

Made by AdhiHub