Skip to content

Windows

  • First you will prepare your windows host for an hypervisor
  • Second you will choose between
    • install debian 12 with WSL to run goad install script
    • Or prepare your windows host (install with a provisioning machine)

Prepare Windows Host

If you want to use virtualbox as a hypervisor to create your vm.

Disk space

The lab takes about 77GB (but you have to get the space for the vms vagrant images windows server 2016 (22GB) / windows server 2019 (14GB) / ubuntu 18.04 (502M)) The total space needed for the lab is ~115 GB (depend on the lab you use and it will take more space if you take snapshots), be sure you have enough disk space before install.

RAM

Depending on the lab you will need a lot of ram to run all the virtual machines. Be sure to have at least 20GB for GOAD-Light and 24GB for GOAD.

If you want to use vmware workstation as an hypervisor to create your vm.

Tip

Vmware workstation is now free for personal use !

Disk space

The lab takes about 77GB (but you have to get the space for the vms vagrant images windows server 2016 (22GB) / windows server 2019 (14GB) / ubuntu 18.04 (502M)) The total space needed for the lab is ~115 GB (depend on the lab you use and it will take more space if you take snapshots), be sure you have enough disk space before install.

RAM

Depending on the lab you will need a lot of ram to run all the virtual machines. Be sure to have at least 20GB for GOAD-Light and 24GB for GOAD.

Nothing to prepare on windows host, install and prepare wsl and next follow linux install from your wsl console : see aws linux install

Nothing to prepare on windows host, install and prepare wsl and next linux install from your wsl console see azure linux install

Not supported, you will have to create a provisioning machine on your proxmox and run goad from then (see proxmox linux install)

Not supported, you will have to act from your ludus server (see ludus linux install)

Prepare python environment

Now your host environment is ready for virtual machine creation. Now we will install WSL to run the goad installation script.

wsl version

New Linux installations, installed using the wsl --install command, will be set to WSL 2 by default. The wsl --set-version command can be used to downgrade from WSL 2 to WSL 1 or to update previously installed Linux distributions from WSL 1 to WSL 2. To see whether your Linux distribution is set to WSL 1 or WSL 2, use the command: wsl -l -v. To change versions, use the command: wsl --set-version <distro name> <wsl_version> replacing with the name of the Linux distribution that you want to update. As an example: wsl --set-version Debian 1 will set your Debian distribution to use WSL 1.

use wsl version1

by now wsl was tested succefully with version 1

Install WSL

Prepare WSL distribution

  • Open debian console then :

    • Verify you are using python version <= 11 

      python3 --version

    • Install python packages 

      sudo apt update
sudo apt install python3 python3-pip python3-venv libpython3-dev

  • Next you can clone and run goad

cd /mnt/c/whatever_folder_you_want
git clone https://github.com/Orange-Cyberdefense/GOAD.git
cd GOAD
./goad.sh

For vmware or virtualbox only

This mode doesn't need WSL but it is only if you plan to install goad locally on vmware or virtualbox

  • Prerequistes:

    • python on your windows (tested ok with python 3.10)
    • git

  • Clone the goad project: git clone https://github.com/Orange-Cyberdefense/GOAD

  • Checkout the v3-beta branch : 
    cd GOAD
git checkout -b v3-beta origin/v3-beta
  • Install python dependencies (choose the noansible file) : 
    pip install -r noansible_requirements.yml
  • Launch goad with vm provisioning method : 
    py goad.py -m vm