Skip to content

Troubleshooting and known limits

The usual causes, in order:

  1. Sunshine is capturing the Hyper-V display instead of the virtual one. Start and open (or ./gpuvm.ps1 connect) points Sunshine at the virtual display every time. If it warns that Sunshine doesn’t see the virtual display, check C:\GpuVM\setup.log inside the VM.
  2. The VM’s driver doesn’t match the host’s (after an NVIDIA driver update). Opening from the app syncs it on its own when the VM is off; or run ./gpuvm.ps1 sync-driver -Name <vm> with the VM off.
  3. Remote Desktop took the session away from the GPU display. Close Remote Desktop and use start and open again: with the guest password saved, GpuVM moves the session back to the console.

If the picture takes a while to show after connecting, check that Picture and control → Capture is on Fast: the Classic capture can stay black until something on screen changes.

To look at the VM’s screen without the GPU, open the Hyper-V console (View Hyper-V console in the machine’s ⋯ menu, or vmconnect.exe localhost <vm>). While the virtual display works, the Hyper-V display is turned off; Remote Desktop still works as a fallback.

Known open issue (lab 002): Sunshine can report “Display device configuration API is temporarily unavailable” and not change the resolution.

The desktop streams fine, but a game or program in exclusive fullscreen shows black (it may appear when it loses focus). That happens with the Classic capture, which can’t see exclusive fullscreen on a virtual display. In Picture and control → Capture choose Fast (the default for new machines) and save. See Capture modes.

A program waits for administrator permission

Section titled “A program waits for administrator permission”

With the Fast capture, Windows’ administrator prompts aren’t drawn in Moonlight; GpuVM shows them in a card over everything, with Allow and Deny (Administrator prompts). If no card appears:

  • GpuVM must be open (in the window or the tray): the card comes from the app.
  • GpuVM needs the VM’s Windows password; without it, the VM shows a banner asking for it.
  • The watcher is installed the first time the VM is opened from GpuVM; open it once with Open.
  • To see the prompts in Moonlight instead, switch to Classic in Picture and control → Capture.

GPU-P VMs have an extra hidden 1024×768 output; if it was the primary display, new windows (Steam, installers) opened there instead of on the streamed display. Start and open fixes it automatically: it keeps the virtual display as the only and primary one. It needs the guest password; if a window is still missing, open the VM again from the app.

Not anymore: in fullscreen, Alt+F4, Alt+Tab and the Windows key go to the VM. To quit the stream, press Ctrl+Alt+Shift+Q. VMs created before this change get it too the next time they open.

GpuVM installs the gamepad driver (ViGEmBus) the first time it opens the VM, with the guest password saved; Sunshine then restarts to use it. If a controller doesn’t respond, open the VM again from GpuVM, and check that Moonlight sees the controller on this PC.

The guest has to use the same driver version as the host. After updating the NVIDIA driver:

  • In the app, a notice appears on the VM; it updates on its own the next time you start it from the app, or right away with Update now / Shut down and update.
  • From the CLI: ./gpuvm.ps1 sync-driver -Name <vm> (VM off), or add -ShutdownIfRunning.
  • ./gpuvm.ps1 list shows whether each VM’s driver is in sync.

The first boot installs Windows and the streaming components, then restarts once. Start and open waits for Windows and for Sunshine, and says so on the button. If Sunshine never responds, the error points to C:\GpuVM\setup.log inside the VM. If the VM never gets an IP address, check its screen with the Hyper-V console and that the Default Switch exists. If the VM is off, saved or paused, opening it says so at once instead of waiting for an address.

The app says the GpuVM service is stopped or missing

Section titled “The app says the GpuVM service is stopped or missing”

The app runs without administrator rights and asks the GpuVM service to do the Hyper-V work. With the service set to Manual, start it with Start service, or change it to With GpuVM in Settings → Service (Settings). If it is missing (for example, after a failed update), Repair registers it again after a UAC prompt; reinstalling GpuVM does the same.

The VM’s sound comes from GpuVM’s USB speaker, Speakers (GpuVM Audio) (Streaming). Start and open installs it, plugs it in again and points Sunshine at it (virtual_sink) whenever it’s missing, as long as the VM’s Windows password is saved in GpuVM. Inside the VM, the server’s status is in C:\ProgramData\GpuVM\Audio\status.json. Without the password, opening the VM shows a warning. If the profile has "audio": "none", no audio device is installed.

Use Pair Moonlight again in the ⋯ menu, or ./gpuvm.ps1 connect -Name <vm> -Pair. If Moonlight isn’t installed, install it (Install).

Hyper-V’s fixed memory must be free when the VM starts. Close programs, or lower the VM’s memory in its Machine section, or open it with Open with N GB when the app offers it (or with -Override @{ vm = @{ memoryGB = 6 } }).

  • Display: the Hyper-V console doesn’t show the GPU; streaming is the way to see it.
  • Audio: the VM has no sound card; GpuVM’s own USB speaker gives it one, verified on a real VM through Moonlight (lab 012).
  • Driver: the guest has to use the same version as the host (see above).
  • GPU selection on Windows 10: you can’t choose which GPU the VM gets. If the integrated GPU is also partitionable, the VM may get the wrong one. check warns about it; disable the integrated GPU in Device Manager before starting the VM (lab 001).
  • No checkpoints or saved state: the VM shuts down instead.
  • Anti-cheat: some anti-cheat systems block virtual machines.