Hyper-V

The Hyper-V backend runs sandboxes as full virtual machines via Microsoft Hyper-V. It's the default backend on Windows and supports both Linux and Windows guests.

Requirements

• Windows 10/11 Pro, Enterprise, or Education (Hyper-V is not available on Home editions)
• A CPU that supports hardware virtualization (Intel VT-x or AMD-V) with virtualization enabled in the BIOS/UEFI
• Hyper-V role enabled

Installation

1. Enable the Hyper-V role

   From an elevated PowerShell prompt:

   Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

   Reboot when prompted.

2. Verify

   Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V

VM images

On first use, heyvm downloads a managed Linux base image from S3 to ~/.heyo/images/hyperv/. Set HEYO_HYPERV_GUEST_OS=windows to switch to a Windows guest.

Usage

heyvm --backend-type hyperv