Skip to main content

Install & usage

Clone the repo, dry-run against your target, then run it for real.

Authorized use onlyScan hosts you own or have written permission to test. Scanning systems without permission is illegal in most jurisdictions.

Requirements​

  • Docker: Docker Desktop on macOS.
  • Bash 3.2+. The macOS default /bin/bash works.

Install​

There's nothing to install globally. The script builds its own image on the first real run.

git clone https://github.com/rtorcato/pentest
cd pentest

Dry-run first​

Always dry-run before a real scan. It prints every phase without building the image or touching the target.

$ ./pentest.sh --target 192.168.1.50 --mode full --dry-run
[WARN] DRY-RUN mode — no changes will be made
==> Phase 1: Port scanning
[INFO] [DRY-RUN] Would run: nmap all-ports + OS detection + scripts
…
[WARN] DRY-RUN complete — no scans were executed

Flags​

FlagValueWhat it does
--targetIP or hostnameRequired. Letters, digits, dots and hyphens only.
--modequick | full | web | checklistWhich phases run. Defaults to quick.
--outputDIRWhere run folders go. Defaults to log/ in the repo.
--dry-runPrint every phase it would run. Builds nothing, scans nothing.
--help, -hPrint usage and modes.

Updating the tools​

The image is cached as pentest-tools. Remove it and the next run rebuilds with current packages.

docker rmi pentest-tools

Output​

Each run writes log/<target>-<timestamp>/ (or under --output DIR) containing report.md and one raw .txt per tool.