Skip to content

Install

  1. Enable Hyper-V (see below) and restart.

  2. Download the installer (NSIS .exe) from GitHub Releases and run it.

  3. Install Moonlight (see below).

  4. Open GpuVM. It opens without administrator rights.

  • Installs GpuVM for the whole machine in Program Files, with its own PowerShell 7, the PowerShell module, the profiles, the guest scripts, the unattend.xml template and the streaming component list inside.
  • Registers the GpuVM service (gpuvm-host.exe), which does the Hyper-V work for the app. By default it starts when the app opens and stops when it quits (see Settings). Uninstalling removes it.
  • The data that changes (labs and downloaded installers) goes to %ProgramData%\GpuVM, which is also restricted to administrators.
  • The installer is in Spanish. The app follows Windows’ display language (Spanish when Windows is in Spanish, English otherwise); change it in Settings → Appearance → Language.

Once, in PowerShell as administrator, then restart:

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

If virtualization is off in the BIOS/UEFI, turn on Intel VT-x or AMD-V there first.

Moonlight shows the VM on your desktop. Download it from moonlight-stream.org, or from the repository run:

Terminal window
./gpuvm.ps1 client-install

It installs Moonlight with winget (MoonlightGameStreamingProject.Moonlight). winget may ask you to accept its terms the first time.

Without the installer, everything uses the repository folder (CLI or development mode).

Terminal window
# CLI, from PowerShell 7 as administrator
./gpuvm.ps1 check -Profile max-performance
# Build the installer (it ends up in app/src-tauri/target/release/bundle/nsis/)
npm --prefix app run tauri build
# Design the UI without Hyper-V (sample data; ?mock=empty, ?mock=noadmin)
npm --prefix app run dev
# Tests (no administrator needed)
Invoke-Pester ./tests