A docker container running a customizable full Kali Linux distribution.
The build script lets you chose
- which Kali Packages to install (core, default everything and so on)
- which Desktop environment to use ( xfce, kde, gnome, mate etc.). It should be noted that not all Desktop Environments work properly.
Download all the files into a subdirectory on your linux docker host, e.g. /home/mdube/kali-linux docker then cd into that directory and run
sudo ./build
The build script then asks you for all the options and builds the image, creates the container and starts it. So in a nutshell, the complete command sequence in a linux shell to install on a Debian or Ubuntu Linux would be:
apt update
apt install git
git clone https://github.com/mdube99/kali-docker.git
cd kali-linux-docker
sudo ./build
You can now connect to the container by launching your favourite remote access software. The default ports defined in the script are as follows:
- RDP on port 3389
- ssh on port 22
The build script will prompt you for an additional user, along with the password for that user.
In the docker-compose file, you can add folders you would like persistent across your host. In the event you need to create a new image, you don't have to worry about losing/transferring files.
You will need to change the home directories on these volumes to match the user that you will use for the image (e.g. mdube)
You will notice in the docker-compose file there is a volume for the browser. This is to store the firefox information (such as foxyproxy) for use with burpsuite. I recommend that you create a set folder for this, to ensure that your browser settings stay persistent after stopping/starting the container.
For using RDP, i recommend using xfreerdp. The following command will allow you to remote into the container, without entering any password:
xfreerdp /u:root /p: /v:10.1.0.2This will prompt you for a username/password when you remote into the box, rather than specifying it in the command line.
If you want to specify the resolution for the remote desktop session, you can use 1920x1080 by using the following command:
xfreerdp /u:root /p: /v:10.1.0.2 /w:1920 /h:1080If you get stuck in the remote desktop session (all key-presses are going to the rdp session), you can press Right-ctrl to have your key-presses go back to the host machine.
If you want to add a program/package to your kali-linux image later, you can use the updateImage script while the container is running. You will want to also add this program/package to your dockerfile if you want to utilize these programs on a fresh install later.
This script will turn off XRDP prior to committing to the docker image, as without this it can cause an issue with RDP upon startup of the container.