Introduction
pentest is a Docker-based security sweep for hosts on your own network. One script builds a throwaway toolbox image, runs the scans in phases, and writes a Markdown report with findings ranked by severity.
Authorized use onlyScan hosts you own or have written permission to test. Scanning systems without permission is illegal in most jurisdictions.
Four modes
| Mode | What it does |
|---|---|
quick (default) | Top-1000 TCP ports and service banners. |
full | All ports, OS detection and NSE scripts, then web, SSL/TLS and SMB phases. |
web | Web ports only, then headers, whatweb, nikto, gobuster and sslscan. |
checklist | Same as full, but asks before each phase. |
Where to go next
- Install & usage: clone, dry-run, run.
- Tools: what runs in each phase and what the report flags.
- Sample report: what
report.mdlooks like.