A management workspace for a KVM/QEMU virtualization lab featuring GPU passthrough (VFIO) and virtiofs shared filesystems, hosting both Linux and Windows guest VMs.

This repo captures the knowledge, procedures, and configuration templates needed to build and maintain a developer workstation that runs guest VMs with direct GPU access and shared code checkouts. The goal is reproducibility — tear it down, rebuild it from these docs.

• Choose and install host OS
• Configure IOMMU and VFIO for GPU passthrough
• Set up virtiofs for shared filesystems
• Create Linux guest VM template
• Create Windows guest VM with virtio drivers
• Validate GPU passthrough end-to-end
• Validate virtiofs code sharing workflow

Work through the procedures in order:

1. Host OS Installation
2. VFIO / GPU Passthrough Setup
3. virtiofs Shared Filesystem Setup
4. Linux Guest VM
5. Windows Guest VM

Reference docs in docs/ provide background and troubleshooting for each topic.

• CPU with IOMMU support (Intel VT-d or AMD-Vi)
• 2+ GPUs (one for host display, one or more for passthrough)
• 32+ GB RAM recommended (host + guests + virtiofs shared memory backing)
• NVMe/SSD storage for VM images