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/bashworks.
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
| Flag | Value | What it does |
|---|---|---|
--target | IP or hostname | Required. Letters, digits, dots and hyphens only. |
--mode | quick | full | web | checklist | Which phases run. Defaults to quick. |
--output | DIR | Where run folders go. Defaults to log/ in the repo. |
--dry-run | Print every phase it would run. Builds nothing, scans nothing. | |
--help, -h | Print 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.