kali-linux-docker

A Docker solution for running a local, customizable full Kali Linux distribution.

Configure the container with the following options:

Exposed ports (vnc, x2go, rdp, ssh)
Desktop environment(xfce, kde, gnome, mate, etc.)
Remote access software (vnc, x2go, rdp)
Kali packages to install (core, default everything, etc.)
Network configuration (host, bridge)
Build platform (amd64, arm64, etc.)
Local Docker image name
Docker container name
Host directory to mount as volume
Container directory for volume mount
Container username
Container user password

how to build

Download all the files into a subdirectory on Docker host, e.g. /home/marc/kali-linux docker then cd into that directory.

Create a copy of the env_template file, and name it env. Enter the desired configuration for each variable.

Run the build script:

`sudo ./build`

If a variable isn't set in the env file, the build script asks for all the options then:

builds the local Docker image
Creates the container from the created image
Starts the new container

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/onemarcfifty/kali-linux-docker.git
cd kali-linux-docker
cp env_template env
[fill_in_env_variables]
sudo ./build

how to use

Connect to the container by launching the software for the configured remote access technique or via SSH. The default ports defined in the script are as follows:

RDP on port 13389
ssh / x2goserver on port 20022
vnc on port 5908 / display :8

All user name and password are configured in the env file or promted by the build script.

more info

Find all details on my youtube channel

You may also want to join THE ONEMARCFIFTY DISCORD SERVER and chat life with me and/or others - cu there ;-)

known issues

RDP seems to only work with XFCE desktop
Not all combinations of remote access protocols with various desktop environments are working

troubleshooting/tips

When using RDP and XFCE, the desktop will take a moment to load the first time (about five seconds or less)

TODO

Disable desktop sleep, screenlock, etc.

3v1ltw1n0x01 / kali-linux-docker Goto Github PK