lfg2025/archy

Dorian 76782073c2 Refactor build script for custom ISO creation and update hardware configuration

- Replaced OS-specific build method with a custom ISO builder in the build-for-hardware.sh script.
- Updated output file naming to reflect the correct Alpine version in the build process.
- Adjusted build dates in hardware configuration files for HP ProDesk, merged, and Start9 Pure profiles to the latest timestamp.

2026-01-31 22:56:39 +00:00

3.1 KiB

Raw Blame History

✅ 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:

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:

./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?

Username: root
Password: (just press Enter)

3. Check Overlay Loaded

# 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

/root/install-archipelago.sh

5. Test Alpine Installation (Optional)

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:

# 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

# 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:

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. 🚀

3.1 KiB Raw Blame History