NOTICE: I am no longer actively maintaining updates to this project. If you need a specific feature, feel free to open an issue and I'll do my best. I personally no longer use this container.
Kali VMs are too slow? Don't want to mess up your main OS with hacking tools? Tired of re-installing your tools in the official Kali container? Looking to get started with hacking with the ability to easily rollback! Then PwnBox is just for you! Get a fully working Kali container with SSH access within minutes!
PwnBox is a helper script alongside a container that is based off Kali's official kali-rolling container, with extra tools installed and an SSH server setup. The setup is very modular, and can be easily adapted to add/remove tools.
The containers are built every week/release and are published to Docker Hub and Github Container Registry.
- A
zshshell with syntax highlighting, auto-suggesstions and more. - A fully modular setup allowing for any tool to be added with ease in future builds.
- All tools installed are organized into their respective categories in
/opt/tools. - Ever installed a tool through
aptand forgot you did? Pwnbox keeps a list of allaptinstalled tools in/opt/tools/CATEGORY/apt_tools.txt. - An
sshserver installed so you can run the container in the background and still access it with ease. - X11 forwarding so you can run GUI applications if needed.
- Weekly builds ensure the latest version of all your favorite tools are installed.
- A companion CLI tool (pwnbox-cli) to make deploying, destroying and updating PwnBox really easy.
- A persistent volume to exchange files with the host OS and persistent any data you need.
- The option to specify a custom startup script for your own customization!
You can easily install the pwnbox command to your system using the following command:
pip install pwnbox # Python >=3.6With the command now installed, you can simply run pwnbox as shown:
pwnbox upThis will download the image if not available, bring up PwnBox container and SSH you in!
You now have access to PwnBox! Remember:
- Explore the installed tools in
/opt/tools. - If you need persistent data or external access, store it in
/mnt/externaland access it on your host from$HOME/.pwnbox/external. - If you need a custom startup script, store it as
$HOME/.pwnbox/external/pwnbox_entrypoint.sh.
NOTE: If you are more interested in downloading and running the container manually, please check the related wiki section
See the usage at pwnbox-cli
Dockerfile- the file that builds the kali docker container.setup/- this directory holds all files related to setting up the container.setup.sh- this is the main setup script.tools/- this directory contains all subcategories of tools and contains the setup scripts for each subcategory.
ssh/- this directory holds all files related to installing and setting up SSH inside the container. It includes static ssh keys.
/opt/tools- this directory contains all the tools installed./mnt/external- this directory is also persistent with every run, but is meant to exchange files between the container and the host./opt/ssh- this directory is used for ssh keys to be automatically imported into the container on launch.
NO_PIP_INSTALL=yesto prevent the installation of python dependencies, reducing build time and container size.NO_PYTHON_INSTALL=yesto prevent the running ofsetup.pyto install python projects and their dependencies, reducing build time and container size.NO_WORDLIST=yesto prevent downloading any wordlists, like SecLists.
Unless those tools are stored in the /mnt/external volume, they will be gone once the container is started up again or upgraded. Additionally, any libraries/dependencies not installed in /mnt/external will also be gone.
Feel free to open Pull Requests with the tool(s) you want to be included! I will review and most likely approve your PR. If not, feel free to just fork and add whatever tools you would like.
PRs are more than welcome! Fix bugs, add features, improve build times, improve container size or anything else. I will gladly merge them once I have reviewed them.