# Hyper-V: AttackBridge installation guide for Windows

Hardware requirements:

1. Resources: at least 4 cores, 16 gb ram, 40 gb of free disk space;
2. CPU capable of hardware virtualisation;

Prerequisites for Hyper-V:

* Windows host that can Hyper-V; Hyper-V itself could be set up automatically. (<https://learn.microsoft.com/en-us/virtualization/hyper-v-on-windows/about/#system-requirements>)

To run AttackBridge in a Linux VM it needs to met following prerequisites:

* a modern Ubuntu LTS Linux installation (24.04);
* at least 2 CPU cores;
* 6 GB or more of RAM;
* at least 30 GB of free disk space;
* a network adapter in a Bridge mode to be capable of ARP discovery and to have an ability to accept incoming connections.

The following guide will provide instructions for Microsoft Hyper-V:

* Open <https://multipass.run/download/windows>; then run downloaded file “multipass-\<version>-win64.exe”

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2FaU19lm3Yso13tPMywdA3%2F1.png?alt=media&#x26;token=39aa0ab5-4150-44cc-85d9-3c10ab4e1729" alt=""><figcaption></figcaption></figure>

* Proceed with an installation, using defaults; reboot your computer if the installer asks to:

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2FS66R5L9wPwaDZShuFeEO%2F2.png?alt=media&#x26;token=3df702bf-c21d-4cff-bf1f-69d05c5c55dd" alt=""><figcaption></figcaption></figure>

* Please look up your network connection name, it would be useful for the next step:

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2FYyLOZxzk2XCYnRpE3O1h%2F3.png?alt=media&#x26;token=eb67a0b2-abe4-4e38-afe4-8455087be6be" alt=""><figcaption></figcaption></figure>

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2F7M1ECvpAW8R0Snqq4Pwa%2F33.png?alt=media&#x26;token=0c4c00c6-f5ce-45e1-9835-d112c7f07b60" alt=""><figcaption></figcaption></figure>

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2FURQTspTKgJ9Zvgo8rjMu%2F333.png?alt=media&#x26;token=7d936c8c-bb37-4381-b2cb-6034ca44b7aa" alt=""><figcaption></figcaption></figure>

* Open a command line prompt ( Press “Win” key, then type “cmd”, then press “Enter”); you need to run the following command to configure the network adapter that will be used for bridging, using its name from the previous step:

```jsx
multipass set local.bridged-network="Ethernet"
```

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2FhM6AU3rRzVwbMvEwne1x%2F4.png?alt=media&#x26;token=0f270369-c108-491a-9f2b-ef4eac10b450" alt=""><figcaption></figcaption></figure>

* Then run the following command to create a new primary VM:

```jsx
multipass launch --name primary --cpus 2 --disk 30G --memory 6G --network bridged
```

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2FYMIrA2ffxzsOPMUwB912%2F5.png?alt=media&#x26;token=000faa4c-ca73-4b0b-bb3d-c627b14a3ac0" alt=""><figcaption></figcaption></figure>

* Answer “yes” if prompted; then wait till the end of installation:

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2FAl5FWoq3Izm5DjD69UFq%2F6.png?alt=media&#x26;token=4512ec92-9eda-4aa7-afc1-f1ce0057db1c" alt=""><figcaption></figcaption></figure>

* Now you can open Linux shell with “multipass shell” command:

```jsx
multipass shell
```

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2FrEMHYK9ZAhkazFuTcNrG%2F7.png?alt=media&#x26;token=aa2bc25a-6c1d-4ea9-a900-b9e2e0690b68" alt=""><figcaption></figcaption></figure>

* Copy and paste this two lines to your terminal, one by one:

```jsx
curl -fsSL [<https://get.docker.com>](<https://get.docker.com/>) -o [get-docker.sh](<http://get-docker.sh/>)
sudo sh ./get-docker.sh
```

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2FefltalubIhlC17wPYMmG%2F8.png?alt=media&#x26;token=7d0b6814-95eb-4777-ba3a-c3d0282d86d1" alt=""><figcaption></figcaption></figure>

* docker should be installed, and you can check if it functions properly with the following command:

```jsx
sudo docker run hello-world
```

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2Fpb7lyzGwVeyyVhmc2OUL%2F9.png?alt=media&#x26;token=796f126f-55d0-4fee-90a3-e82860c69e7a" alt=""><figcaption></figcaption></figure>

* Now that the system has been updated and docker is installed, it is ready for your AttackBridge script. Simply paste your script into the terminal once you're ready.

<figure><img src="https://408956226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeafFRlXcLbm99tlbJrbl%2Fuploads%2FXRTyLlfPIxeQwiagg17G%2F10.png?alt=media&#x26;token=6abe90cd-c449-4a0a-b3b2-38a6843b5102" alt=""><figcaption></figcaption></figure>
