Skip to content

Quick start

For a server that meets the requirements, with your network plan ready.

1. Install the manager and decoys

git clone https://github.com/RedSideSecurity/ReD-Pot.git
cd ReD-Pot
sudo ./install.sh

Choose [1] Manager + decoys and answer five short steps:

  1. the management interface,
  2. your AD/DNS domain and industry,
  3. which decoy roles,
  4. the interface and host name of each decoy,
  5. access: who may reach the web UI, the sensor API and host SSH.

Type back to return to the previous step. Nothing changes on the server until you confirm the review screen.

2. Log in

At the end the installer prints the web address, the admin token and the ports. They are also saved to /opt/redpot/manager/INSTALL-INFO.txt (root only). Open the address, accept the certificate warning once, and paste the token. ReD-Pot runs as the redpot systemd service and starts on boot.

3. Test it

From a workstation in a decoy's network, scan or touch a decoy:

nmap -Pn -p 1-1024 <decoy-ip>

An incident appears on the Overview and Incidents tabs within seconds. More tests per role are in Testing your decoys.

4. Add a decoy in another network (optional)

In the console, open Deception → Add a sensor (another server). It gives you a one-time join string. On the other server:

git clone https://github.com/RedSideSecurity/ReD-Pot.git
cd ReD-Pot
sudo ./install.sh sensor

Paste the join string when the installer asks for it. See Remote sensors.

Common follow-ups

I want to Command
a new admin token (lost or leaked) sudo ./install.sh reset-token
a decoy on a new network card sudo ./install.sh add-decoy
change who may reach the web UI, sensor API or SSH sudo ./install.sh set-access
export incidents sudo ./install.sh export --from 2026-11-01 --to 2026-11-13
update to a new release git pull, then sudo ./install.sh update
remove everything sudo ./install.sh uninstall