> For the complete documentation index, see [llms.txt](https://sxipher.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sxipher.gitbook.io/docs/hyper-v-attackbridge-installation-guide-for-windows.md).

# 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="/files/HFJd2EUk08oROd8L2zqi" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/DE7sfkctvwO9zXivHfbE" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/b39SzcmMhJUEgutgrYYn" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/bvFDCTOPg7jq97mgY4HP" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/tMEGYt0JuilvyRykfsfd" 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="/files/gym981Ya5OUuRRU7ZM3m" 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="/files/3kpcxj2Hr9wkJpUeAefI" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/IQbcTLmZhDKFJGnZ5rXD" alt=""><figcaption></figcaption></figure>

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

```jsx
multipass shell
```

<figure><img src="/files/HRzreggyKyVp0dUKi7x1" 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="/files/NrXQ4YN0onyJN5Db5hP4" 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="/files/sjdKbj3xNqQ7L95xYjrG" 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="/files/GwOQc2Gigcw9aFrCTSIW" alt=""><figcaption></figcaption></figure>