# Ludus Range

Based on <https://ludus.cloud/>

In practice:

* Ludus Hardware: Debian 13 base installation, then run as root:
  * cat /usr/share/doc/apt/examples/Debian.sources > /etc/apt/sources.list.d/debian.sources
  * vi /etc/apt/sources.list (comment out cdrom)
* Install Ludus:  &#x20;
  * apt update && apt install curl sudo git ca-certificates python3-debian
  * curl -s <https://ludus.cloud/install> | bash
* After installation/setup, run the following to disable sleep/hibernation settings:
  * sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target
  * sudo systemctl status sleep.target suspend.target hibernate.target hybrid-sleep.target (to check and confirm "inactive (dead)"
* Configure Ludus:
  * ludus-install-status (to receive Root API Key)  &#x20;
    * LUDUS\_API\_KEY='\<API KEY VALUE FROM ABOVE' ludus user add --name "Ludus Admin" --userid ludusadmin --admin --url <https://127.0.0.1:8081>
    * Take the results of the API key for the new user (ludusadmin) and export  &#x20;
    * export LUDUS\_API\_KEY='\<API KEY VALUE FROM ABOVE'
    * To look up Proxmox credentials
      * ludus user creds get (to access WebUI)
* Add secondary disk to server:
  * lsblk to confirm/find disk
  * fdisk /dev/\<diskname> (ex: sda)
    * g for GPT partition type
    * n for New partition
    * Enter to accept defaults for first and last sectors
    * t to change partition type to LVM (8e)  &#x20;
    * w to write changes
    * pvcreate /dev/\<diskname> (ex: sda1)
    * vgcreate \<new\_vg\_name> /dev/\<diskname>
      * optionally extend \<existing\_vg\_name> /dev/\<diskname>  &#x20;
    * lvcreate -l +100%FREE -n \<volumename> \<new\_vg\_name>
    * mkfs.ext4 /dev/\<new\_vg\_name/
    * mkdir /mnt/LudusData
    * mount /dev/\<new\_vg\_name>/ /mnt/LudusData (temporary access)  &#x20;
    * blkid /dev/\<new\_vg\_name>/ (to lookup UUID - ensure it's from the LVM and not the disk itself)
    * vi /etc/fstab   - UUID="\<UUID FROM ABOVE>" /mnt/LudusData ext4 defaults 0 2
    * mount -a to confirm fstab is correct    (permanent disk access)
    * In Proxmox (as root), add storage

Follow-on:

* <https://minder-security.ghost.io/ludus-build-a-purple-teaming-test-environment/>
* <https://aguidetopurpleteaming.com/part-II/environment-setup/>
* <https://www.splunk.com/en_us/blog/security/splunk-attack-range-v4-threat-detection-emulation.html>
* <https://maldev.nl/posts/ludus-cloudflare/>
* <https://github.com/iknowjason/AutomatedEmulation>
* <https://github.com/Orange-Cyberdefense/GOAD>
* <https://github.com/Antonlovesdnb/ConstructingDefenseLab>
* <https://github.com/Antonlovesdnb/TTPRunner?tab=readme-ov-file>