Windows VM
windows-vm manages a Windows virtual machine running under bhyve via vm-bhyve. Connect via RDP for a full desktop experience. The VM auto-stops when you close the RDP session unless --keep-alive is passed.
Install
Section titled “Install”windows-vm installInteractive setup: choose RAM, CPU cores, disk size, and Windows credentials. If ZFS is present, the VM disk is stored on a ZFS dataset. After setup, provide a Windows ISO to begin installation. Connect via VNC to complete the Windows setup wizard:
vncviewer localhost:5900Commands
Section titled “Commands”| Command | Action |
|---|---|
windows-vm install | First-time setup and configuration |
windows-vm launch | Start VM and connect via RDP (stops on exit) |
windows-vm launch -k | Start VM, keep running after RDP closes |
windows-vm stop | Shut down the VM |
windows-vm status | Show current VM state |
windows-vm remove | Destroy VM and delete all data |
Requirements
Section titled “Requirements”CPU virtualization (VT-x or AMD-V) must be enabled in BIOS. The vmm kernel module is loaded automatically. Required packages installed by windows-vm install: vm-bhyve, edk2-bhyve, freerdp3, gum, tigervnc-viewer.
RDP Connection
Section titled “RDP Connection”After Windows is installed and RDP is enabled inside Windows, windows-vm launch connects automatically using the credentials from setup. The xfreerdp3 client provides clipboard sharing, audio forwarding, and dynamic resolution.
App Launcher
Section titled “App Launcher”After install, Windows appears in the Fuzzel launcher (Super + Space) as a desktop entry.