Skip to content

Try it in a lab

You can try ReD-Pot on one Linux machine with Docker: a lab VM, not a production server. The lab runs the manager and 3 decoys (file server FS01, domain controller DC01, web server WEB01) on an isolated Docker bridge network, and simulated workstations attack them as containers. The script tests/lab_scenarios.sh in the repository does all of it.

Lab only

The lab bridge mode is for evaluation. In this mode decoys can reach the Docker host's bridge IP. Do not use it to protect a real network.

git clone https://github.com/RedSideSecurity/ReD-Pot.git
cd ReD-Pot
sudo docker build -t rpot:1.0.1 .
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt     # rpotctl needs the Python packages
sudo env PATH="$PWD/.venv/bin:$PATH" IMG=rpot:1.0.1 tests/lab_scenarios.sh all   # setup + attack; run as root
# Console: https://127.0.0.1:8740  (admin token: console.admin_token in ./lab/rpot.json)
Command What it does
tests/lab_scenarios.sh setup builds the lab only (rpotctl init --net-mode bridge with 3 decoys, rpotctl compose, docker compose up)
tests/lab_scenarios.sh attack runs the simulated workstations against a running lab
tests/lab_scenarios.sh all both
tests/lab_scenarios.sh down stops the lab (./lab is kept)
DRY_RUN=1 tests/lab_scenarios.sh all prints every command instead of running it

Settings come from the environment: P (project name, default rpotlab), IMG, DIR (default ./lab), PRE (lab subnet prefix, default 172.30.50), DOMAIN, PROFILE and the decoy names FS_NAME, DC_NAME, WEB_NAME.

Note

Set IMG to the tag you built (IMG=rpot:1.0.1 above). The script's built-in default image tag is rpot:1.0.0.

What the simulated workstations do

Scenario Expected result
an allow-listed scanner recorded, no incident
a stray touch L1
an HR user opening a share by mistake L3
SSH password spraying L3
the full breadcrumb chain FS01 → WEB01 → DC01 with a bait document L5
Active Directory recon with a GPP password, LDAP spraying and Kerberoasting L4 / L5

Internet attackers with real public source IPs from 12 countries, for the world map:

sudo tests/internet_sim.sh rpotlab rpot:1.0.1 ./lab        # DRY_RUN=1 prints the commands

Without Python packages on the host, run the CLI from the image instead, for example docker run --rm --user 0 -v $PWD/lab:/d rpot:1.0.1 ctl init -d /d --net-mode bridge ... (the same for ctl compose and ctl geoip). A lab is limited to 3 decoys like any other install.