##         .
                  ## ## ##        ==
               ## ## ## ## ##    ===
           /"""""""""""""""""\___/ ===
      ~~~ {~~ ~~~~ ~~~ ~~~~ ~~~ ~ /  ===- ~~~
           \______ o           __/
             \    \         __/
              \____\_______/

 ___   _  _______  ___      ___     ______   _______  _______  ___   _  _______  ______
|   | | ||   _   ||   |    |   |   |      | |       ||       ||   | | ||       ||    _ |
|   |_| ||  |_|  ||   |    |   |   |  _    ||   _   ||       ||   |_| ||    ___||   | ||
|      _||       ||   |    |   |   | | |   ||  | |  ||       ||      _||   |___ |   |_||_
|     |_ |       ||   |___ |   |   | |_|   ||  |_|  ||      _||     |_ |    ___||    __  |
|    _  ||   _   ||       ||   |   |       ||       ||     |_ |    _  ||   |___ |   |  | |
|___| |_||__| |__||_______||___|   |______| |_______||_______||___| |_||_______||___|  |_|

This is my fork of mikeflynn/kali-docker. Feel free to fork the original or this version for yourself. I didn't like the idea of using Make to start my "hacker" session, so I rewrote the Makefile to a shell script with pretty much the same functionality.

The follow features were added over time:

• X11 socket mapping to start gui "natively"
• vnc function to access the docker container within a browser
• popular security related repos
• popular hacking tools (from packet manager and github)
• function/alias to help and speed up daily hacking tasks
• easier integration for configuration files of your linux daily driver
• example configuration files

The prebuild image is also available on dockerhub:

docker pull braunbearded/kali-docker:latest

The image is quite big so keep that in mind.

I wasn't satisfied with any of the existing Kali Docker setups, so I made my own that has a more efficient Dockerfile and a custom set of software.

If there are cool apps that make sense to add to this, please submit a pull request so we can have the best possible subset of apps for people to spin up and use via Docker.

1. Docker.
2. The knowledge of what to do with Kali.

> cd ./kali-docker
> ./kali.sh up
...
> ./kali.sh shell

Once the container is built and running you will are attached to a shell within docker.

> ./kali.sh help
help     Show this help message
shell    Open shell in kali container
up:      Start kali container
build:   Build kali image and start container
stop:    Stop kali container
clean:   Stop and remove kali containers

Once in the Kali shell you can add them as you normally would with apt install ..., but if you want the apps already in place upon rebuild you can edit the Dockerfile to include whatever app you'd like.