Skip to content

Installation Guide

Jump to bottom
gx1 edited this page Oct 10, 2025 · 6 revisions

The following tutorial is tested for the latest Kali Linux distributions and also for Ubuntu 20.04 LTS. It will soon be provided a bash script that automatize the installation of the dependencies.

1 - Clone Docker Security Playground from GitHub

If you haven't installed Git, open a shell and type : sudo apt-get install git

Clone DSP repository with :

git clone https://github.com/giper45/DockerSecurityPlayground.git

A repository with DSP has now been created in your main folder ( root/DockerSecurityPlayground )

2 - Install prerequisites libraries

The installation of nodejs differs for Kali Linux and Ubuntu

Kali Linux :

sudo apt install nodejs

Ubuntu 20.04 LTS :

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
apt-get install -y nodejs
apt-get install -y build-essential

Install Docker and NPM

sudo apt install docker.io

sudo apt install npm

Make sure that you already have g++ installed and build-essentials.

sudo apt install g++

sudo apt-get update

sudo apt-get install build-essential

3 - Install Docker Compose and mydockerjs API

Download the Docker Compose binary into the /usr/local/bin directory

sudo curl -L "https://github.com/docker/compose/releases/download/1.23.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Apply executable permissions to the Compose binary

sudo chmod +x /usr/local/bin/docker-compose

Download mydockerjs API, a javascript utility library for docker and docker-compose, it provides a simple javascript wrapper in order to execute docker commands and an api in order to use Docker with a node server.

npm install --save mydockerjs

4 - Install NPM libraries and start

Go in DSP directory

cd DockerSecurityPlayground

Install the required packages with npm

npm install express

npm install body-parser

npm install update

npm run update

npm install ws

The following cmd will start the application :

npm start

DSP is running on your machine. Now open any browser and go to http://localhost:18181 to be sure all went well.

  • Configure Docker user group permissions

sudo groupadd docker

sudo gpasswd -a ${USER} docker

sudo service docker restart

  • Set Docker to auto-launch on startup

sudo systemctl enable docker

Clone this wiki locally