Ludus Lab Platform

🧪 Ludus Lab

Build Realistic Active Directory Labs for Red & Purple Team Practice

---

📌 What is Ludus?

Ludus is an Infrastructure-as-Code (IaC) platform designed to rapidly build, destroy, and manage realistic cyber security labs using Ansible, VMware, and modular role-based deployments.

Unlike traditional lab tools, Ludus allows you to:

• Spin up full Active Directory environments

• Deploy attack + defense tooling

• Rebuild labs repeatedly for safe practice

• Learn real-world AD attack paths in a controlled setup

Ludus is ideal for Active Directory Red Teaming, Purple Team exercises, and hands-on security training.

🔗 Official Docs: https://docs.ludus.cloud/docs/intro

---

🧠 Why Use Ludus for Active Directory Practice?

Feature	Benefit
Ansible-based	Declarative, repeatable lab builds
Role-driven	Easy AD, Windows, Linux deployments
Reset-friendly	Destroy & rebuild labs instantly
Real tooling	Practice with real enterprise setups
Scalable	Small labs → complex multi-domain forests

---

🧩 Architecture Overview

Ludus works on top of:

• VMware ESXi / Workstation

• Ansible

• Python

• YAML-based configuration

Each lab is defined as code, not manual clicks.

Your Machine
 ├── Ludus Controller
 │   ├── Ansible
 │   ├── Roles
 │   └── Lab Config (YAML)
 └── VMware Hypervisor
     ├── Domain Controller
     ├── Domain Users
     ├── File Servers
     ├── Attack VM
     └── Defense VM

---

⚙️ Prerequisites

System Requirements

• Linux (Ubuntu recommended)

• Python 3.8+

• VMware ESXi or VMware Workstation

• SSH access to hypervisor

Required Tools

sudo apt update
sudo apt install -y python3 python3-pip git ansible

---

🚀 Installing Ludus

git clone https://github.com/badsectorlabs/ludus.git
cd ludus
pip3 install -r requirements.txt

---

🏗️ Building Your First Active Directory Lab

ludus:
  lab_name: ad-lab
  machines:
    - name: DC01
      role: windows-domain-controller
    - name: USER01
      role: windows-domain-member
    - name: ATTACK01
      role: linux-attack-box

ansible-playbook deploy.yml

---

🔁 Resetting Labs

ansible-playbook destroy.yml

---

⚠️ Ethics

Use Ludus only in authorized lab environments.