Installation

One-Line Install

curl -fsSL https://raw.githubusercontent.com/pingless/pentest-v3/main/install.sh | bash

The installer downloads the latest release (or builds from source if no release matches your platform) and optionally copies the binary to /usr/local/bin/.

Manual Install

git clone https://github.com/AnAverageBeing/Penetration-v3.git
cd Penetration-v3
chmod +x install.sh
./install.sh

Build from Source

Requirements: Go 1.21+

git clone https://github.com/AnAverageBeing/Penetration-v3.git
cd Penetration-v3
go mod download
go build -o pentest-v3 .
sudo cp pentest-v3 /usr/local/bin/

Authentication Setup

Penetration-v3 fails closed if PENTEST_AUTH_HASH is not set. Generate a bcrypt hash of your password:

python3 -c "import bcrypt; print(bcrypt.hashpw(b'mysecret', bcrypt.gensalt()).decode())"
export PENTEST_AUTH_HASH='<paste-hash-here>'

Add the export to your shell profile to persist it.

Post-Install Verification

# Should print help without requiring auth
pentest-v3 --help

# Should prompt for password and run
pentest-v3 protocol:udp ip:127.0.0.1 port:9 pps:1 duration:1

Supported Platforms

OS	Arch	Status
Linux	amd64, arm64	✅ Full support
macOS	amd64, arm64	✅ Full support
FreeBSD	amd64	✅ Supported
OpenBSD	amd64	⚠️ Limited
Windows	amd64	❌ Not supported (use WSL)

GitHub Codespaces

1. Open the repo on GitHub: https://github.com/AnAverageBeing/Penetration-v3
2. Click <> Code → Codespaces → Create codespace on master
3. Build and run:

go build -o pentest-v3 .
export PENTEST_AUTH_HASH='$(python3 -c "import bcrypt; print(bcrypt.hashpw(b\"mysecret\", bcrypt.gensalt()).decode())")'
./pentest-v3 protocol:udp ip:127.0.0.1 port:8080 pps:1000

Codespaces Note

Codespaces runs as a non-root container, so raw-socket methods fall back to non-root alternatives. Application-layer methods work fully.

Troubleshooting

Problem	Cause	Fix
PENTEST_AUTH_HASH is not set	Missing env var	Generate and export a bcrypt hash
Access denied	Wrong password or wrong hash	Verify the password matches the hash
RAW needs root	Raw socket methods need privileges	Run with sudo or grant CAP_NET_RAW
bind: permission denied	Low ports (<1024) need root	Use high ports or run with sudo
Build fails	Go version too old	Install Go 1.21+

Uninstall

sudo rm -f /usr/local/bin/pentest-v3
rm -rf /path/to/Penetration-v3