Skip to content

Requirements

Operating system

Minimum Recommended
Distribution Debian-family Linux with apt and systemd: Ubuntu 22.04+ or Debian 12+ Ubuntu 24.04 LTS or 26.04 LTS, server edition, minimal install
Architecture x86_64 (amd64) x86_64. An ARM64 image is published but not tested yet
Kernel any stock kernel with iptables (xt_TTL for the Windows TTL rule; without it the decoy keeps TTL 64) the distribution's current LTS kernel
Python on the host 3.8+ (only for the installer, which uses the standard library only) the distribution's default python3
Docker 20.10+ with the compose plugin. Installed automatically if missing (the installer asks first) the distribution's docker.io package, or Docker CE
Not supported Windows, macOS, WSL, RHEL / Rocky / Alma (no apt), Alpine, containers inside containers

Hardware

Minimum Recommended Measured
Manager + local decoys: CPU 1 vCPU 2 vCPU near 0 % when idle
RAM 1 GB 2 to 4 GB about 140 MB for the manager with two decoys; about 50 MB per extra decoy
Disk 5 GB free 20 GB SSD (90 days of events, alert archives) image about 280 MB
Network interfaces 1 (holds one local decoy, which shares the management IP) 2 to 4: one for management, one per decoy
Remote sensor: CPU / RAM 1 vCPU / 512 MB 1 vCPU / 1 GB about 65 to 100 MB RAM
Disk 3 GB free 5 GB
Interfaces 1 (the decoy may share it) 1, or 2 if the decoy should sit in another VLAN
Link to the manager any routed TCP path to the sensor API port the same LAN or a VPN about 0.6 kbit/s idle, about 5 MB per day

Also needed

  • root or sudo.
  • Internet access during the first install (apt packages, the Docker image, the optional GeoIP download of about 18 MB). After that ReD-Pot runs fully offline.
  • Static or DHCP-reserved IP addresses on the management interface and on every interface that holds a decoy, and correct time (NTP). Event timelines depend on it.
  • uid 10001 must be free on the host: it is the containers' user. The installer refuses to install when a host account or process uses it.

Virtual machines

Each decoy answers on the IP and MAC address of the VM's own network adapter, so no promiscuous mode or MAC spoofing is needed on VirtualBox, VMware, Hyper-V or Proxmox. To place decoys in several networks, give the VM one adapter per network. Wi-Fi interfaces work too.