Quick start¶
For a server that meets the requirements, with your network plan ready.
1. Install the manager and decoys¶
Choose [1] Manager + decoys and answer five short steps:
- the management interface,
- your AD/DNS domain and industry,
- which decoy roles,
- the interface and host name of each decoy,
- 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:
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:
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 |