Troubleshooting

Things that commonly go wrong, and how to get past them.

Regulus can't open /dev/kvm

Your user needs access to the KVM device. On most distributions you add yourself to the kvm group and log back in:

sudo usermod -aG kvm "$USER"

If /dev/kvm doesn't exist at all, hardware virtualization is probably turned off in your firmware. The enable virtualization guide covers that.

Windows never finishes installing

The first run downloads a full Windows image and installs it, which can take a while on a slow connection. Let it finish. If it stalls for good, remove the machine in Regulus and start again.

An app doesn't show up

Regulus discovers apps through its agent inside Windows, Leo. Install what you need with winget inside the Windows session, then refresh the app list in Regulus.

There's no sound

Sound comes through the RDP stream. Make sure your host is running PipeWire and that the app isn't muted inside Windows.

Still stuck?

Search the issue tracker first, and open a new issue if nothing matches.