Preparation

VyOS

Download the latest amd64 release from the VyOS website.

For the purpose of the instructions in this guide, it is assumed you have downloaded the VyOS ISO file to the C:\ISO directory on your computer. If you have used a different location, please adjust the following instructions accordingly.

Hyper-V

Before installing VyOS, we need to create a new Virtual Machine on the Hyper-V host. The following Virtual Machine settings are recommended:

Hyper-V Virtual Machine Settings
	Generation	1
	Processors	1
	Memory	256 MB (Static)
	Hard Drive	2 GB (Dynamically Expanding)
	Network Adapter	10 Gbps (WAN/External)
	Network Adapter	10 Gbps (LAN/Internal)

The first Network Adapter is used for all external (WAN) communications between the router and the outside world. It is assumed that this interface will be configured using DHCP.

The second Network Adapter is used for all internal (LAN) communications between the router and its routed networks. VLANs are used to facilitate an almost unlimited number of routed networks through this second Network Adapter interface.

As we are implementing some advanced VLAN options on the second Network Adapter, it is not possible to create a new Virtual Machine using Hyper-V Manager – as these options are not exposed through the user interface. Instead, we must create a Virtual Machine from the command-line using Windows PowerShell.

To create a new Hyper-V Virtual Machine for VyOS, perform the following steps from the Windows PowerShell ISE (Run as Administrator).

1. Set scripting parameters, using the following commands:

   $VyOS_Name = "VyOS Router"
   $VyOS_ISO = "C:\ISO\vyos-1.1.6-amd64.iso"

   Change VyOS Name as required. Ensure VyOS ISO path is correct.

2. Set scripting variables, using the following commands:

   $VirtualHardDiskPath = (Get-VMHost).VirtualHardDiskPath
   $FastestPhysicalAdapter = (Get-NetAdapter -Physical | Where-Object {$_.Status -eq 'Up'} | Sort-Object $_.LinkSpeed | Select-Object -First 1).Name
   If (((Get-VMSwitch -SwitchType External).Name) -eq $null) {New-VMSwitch -Name 'External' -NetAdapterName $FastestPhysicalAdapter -AllowManagementOS $true -Notes 'External Switch'}
   $ExternalSwitch = (Get-VMSwitch -SwitchType External).Name

   The above determines if an external interface exists, and if not, then creates one.

3. Create a Hyper-V Private virtual switch, using the following commands:

   New-VMSwitch -Name "$VyOS_Name - Private Switch" -SwitchType Private -Notes "$VyOS_Name - Private Switch"

   The commands produce output similar to the following:

   Name                         SwitchType NetAdapterInterfaceDescription
   ----                         ---------- ------------------------------
   VyOS Router - Private Switch Private

4. Create the VyOS Virtual Machine, using the following commands:

   New-VM -Name $VyOS_Name -Generation 1 -MemoryStartupBytes 256MB -NewVHDPath $VirtualHardDiskPath\$VyOS_Name.vhdx -NewVHDSizeBytes 2GB -SwitchName $ExternalSwitch
   Set-VM -VMName $VyOS_Name -ProcessorCount 1 -StaticMemory -Notes "VyOS Router`r`nCreated:`t$((Get-Date).ToString())`r`nSource:`t$(Split-Path $VyOS_ISO -Leaf)"
   Rename-VMNetworkAdapter -VMName $VyOS_Name -Name "Network Adapter" -NewName "Network Adapter (External)" 
   Add-VMNetworkAdapter -VMName $VyOS_Name -Name "Network Adapter (Internal)" -SwitchName "$VyOS_Name - Private Switch"
   Set-VMNetworkAdapterVlan -VMName $VyOS_Name -VMNetworkAdapterName "Network Adapter (Internal)" -Trunk -NativeVlanId 0 -AllowedVlanIdList 1-4094

   The command will produce output similar to the following:

   Name        State CPUUsage(%) MemoryAssigned(M) Uptime   Status             Version
   ----        ----- ----------- ----------------- ------   ------             -------
   VyOS Router Off   0           0                 00:00:00 Operating normally 7.0

5. Connect the installation ISO to the VyOS Virtual Machine, using the following command:

   Set-VMDvdDrive -VMName $VyOS_Name -Path $VyOS_ISO

6. Start the VyOS Virtual Machine, using the following command:

   Start-VM -Name $VyOS_Name

   The VyOS Virtual Machine will start and boot to the login prompt.

Leave the Windows PowerShell ISE window open.