virtualization

# Virtualization - Bazzite GPU Passthrough & KVM

## Overview

Advanced virtualization features for Bazzite including KVM, VFIO GPU passthrough, Looking Glass (kvmfr), and USB hotplug for VMs.

## Quick Reference

| Command | Description |
|---------|-------------|
| `ujust setup-virtualization` | Main virtualization setup |
| `ujust setup-virtualization virt-on` | Enable KVM/libvirt |
| `ujust setup-virtualization virt-off` | Disable KVM/libvirt |
| `ujust setup-virtualization vfio-on` | Enable VFIO passthrough |
| `ujust setup-virtualization vfio-off` | Disable VFIO passthrough |
| `ujust setup-virtualization kvmfr` | Setup Looking Glass |
| `ujust setup-virtualization usbhp-on` | Enable USB hotplug |
| `ujust setup-virtualization usbhp-off` | Disable USB hotplug |

## KVM/Libvirt

### Enable Virtualization

```bash
# Enable KVM and libvirt
ujust setup-virtualization virt-on
```

**Enables:**
- libvirtd service
- User permissions for VMs
- Default network
- QEMU/KVM backend

### Disable Virtualization

```bash
# Disable KVM and libvirt
ujust setup-virtualization virt-off
```

## VFIO GPU Passthrough

### Enable VFIO

```bash
# Enable VFIO for GPU passthrough
ujust setup-virtualization vfio-on
```

**What VFIO does:**
- Isolates GPU from host
- Passes GPU directly to VM
- Near-native GPU performance in VM

**Requirements:**
- Two GPUs (or iGPU + dGPU)
- IOMMU support (VT-d or AMD-Vi)
- Supported GPU

### Disable VFIO

```bash
# Disable VFIO passthrough
ujust setup-virtualization vfio-off
```

Returns GPU to host control.

## Looking Glass (kvmfr)

### Setup kvmfr

```bash
# Setup Looking Glass shared memory
ujust setup-virtualization kvmfr
```

**Looking Glass:**
- Zero-copy GPU framebuffer sharing
- Near-zero latency display
- No GPU encoding needed
- Mouse/keyboard passthrough

**Requirements:**
- Windows VM with GPU passthrough
- Looking Glass host app
- IVSHMEM device in VM

### Using Looking Glass

1. **Host:** Run `looking-glass-client`
2. **VM:** Run Looking