# ✅ QEMU Testing Setup Complete!

## What We Installed

- **QEMU 10.2.0** (full x86_64 emulation)
- **20GB virtual disk** (`/tmp/archipelago-test-disk.qcow2`)
- **Test script** (`test-iso-qemu.sh`)

## How to Test ISOs

### Quick Test:
```bash
cd /Users/dorian/Projects/archy/image-recipe
./test-iso-qemu.sh
```

A QEMU window will open showing the VM booting from your ISO!

### Test Specific ISO:
```bash
./test-iso-qemu.sh /path/to/your.iso
```

## VM Specs

- **RAM**: 2GB
- **CPU**: 2 cores
- **Disk**: 20GB virtual disk
- **Network**: NAT (automatically configured)
- **Display**: VirtIO GPU

## Controls

- **Release mouse/keyboard**: Ctrl+Alt+G
- **Stop VM**: Close window or Ctrl+C in terminal
- **Fullscreen**: Ctrl+Alt+F

## What to Test

### 1. Boot Sequence
- Does it boot to Alpine login? ✅ or ❌
- Any emergency shell? ❌ (should NOT appear with overlay ISO!)
- Does overlay load automatically?

### 2. Login Test
```
Username: root
Password: (just press Enter)
```

### 3. Check Overlay Loaded
```bash
# Check if overlay files are present
ls -la /root/install-archipelago.sh
ls -la /usr/local/bin/archipelago
ls -la /usr/share/archipelago/web
```

### 4. Test Installer
```bash
/root/install-archipelago.sh
```

### 5. Test Alpine Installation (Optional)
```bash
setup-alpine
```

## Expected Boot Flow

```
1. QEMU starts
   ↓
2. BIOS/GRUB loads
   ↓
3. Alpine kernel starts
   ↓
4. Overlay (archipelago.apkovl.tar.gz) detected
   ↓
5. Overlay extracted to /
   ↓
6. Welcome message appears
   ↓
7. Login prompt
```

## Current Test Status

**QEMU is currently running!** Check for the QEMU window on your screen.

You should see:
- Either Alpine boot messages scrolling by
- Or a login prompt with the Archipelago welcome message

## Stopping the VM

To stop the VM:
```bash
# Press Ctrl+C in the terminal where you ran the script
# Or close the QEMU window
```

## Advantages of QEMU Testing

✅ **Fast**: No USB flashing needed  
✅ **Repeatable**: Test as many times as you want  
✅ **Safe**: No risk to physical hardware  
✅ **Debugging**: Easy to see boot messages  
✅ **Quick iteration**: Rebuild ISO → Test in seconds  

## Workflow for Future Builds

```bash
# 1. Build new ISO
cd /Users/dorian/Projects/archy/image-recipe
./build-overlay-iso.sh

# 2. Test in QEMU
./test-iso-qemu.sh

# 3. If it works, flash to USB for real hardware
diskutil list
diskutil unmountDisk /dev/diskN
sudo dd if=results/archipelago-3.19-hp-prodesk-uefi-x86_64.iso of=/dev/rdiskN bs=1m
```

## Troubleshooting

### VM doesn't start
Check the terminal output:
```bash
tail -50 /Users/dorian/.cursor/projects/Users-dorian-Projects-archy/terminals/68354.txt
```

### Black screen
- Wait 30 seconds (VM might be loading)
- Press Enter to see if login prompt appears

### Can't see QEMU window
- Check your Dock for QEMU icon
- Check Mission Control (Cmd+Up) for windows

### VM is too slow
This is normal - QEMU emulation (not virtualization) is slow on ARM Mac. It's still faster than flashing USB drives though!

---

**Look for the QEMU window on your screen now!** You should see Alpine booting. 🚀