hexcowboy / jackbox-archived

A light-weight, persistent, and quickly deployable docker box with pentesting and cybersecurity tools preinstalled.

JackBox

A super-tiny (less than 1GB) Docker container that provides a penetration testing environment.

• Runs on Windows, Mac, Linux (anything that runs Docker)
• Setup in as little as 1 minute
• Default configuration is a completely ready environment

Yes, it's faster than a VM.

🎡 Environment

• OS - Debian a free and open-source linux distributionn
• Package Managers - Homebrew for Linux and Debian's apt
• Shell - Bash, Zsh, Fish, and/or Powershell all with a pre-configured starship prompt
• Productivity Tools - Neovim (symlinked to vi and vim), Fzf, RipGrep, Tmux, HTTPie/Curl/Wget
• Pentesting - nmap, sqlmap, SecLists, wpscan, mitmproxy

... and much more outlined in the Documentation

🚀 Quickstart

Follow instructions for downloading and installing Docker on you host machine. If your host machine is Linux then you will also need to install Docker Compose.

# Download the repo
git clone https://github.com/jackno/jackbox.git
cd jackbox

# Setup
docker-compose run jackbox setup

# Start
docker-compose up jackbox

# Connect to JackBox via SSH
ssh <user>@localhost

🧼 Cleanup

⚠️ Data in the /etc, /opt, /home, and /var paths are persistent, but nothing else is.

# Close out your session without deleting your data.
docker-compose down jackbox

# The -v option will completely delete all your persistent data. Make sure you back up sensitive files.
docker-compose down jackbox -v

📚 Documentation

This is a work in progress.

🤝 Contributing

Feature Requests please make a post here

Bugs please report here

📃 License

JackBox is licensed under the MIT License.