Skip to content

v2.5.2

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 28 May 21:02
· 3 commits to main since this release
v2.5.2
15587b9

macOS QEMU Guest Agent v2.5.2

Setup

PVE host (one-time):

qm set <vmid> --agent enabled=1,type=isa

macOS VM:

# One binary covers macOS 10.4 Tiger through 26 Tahoe (i386 + x86_64 + arm64).
# On Tiger / Leopard / older Snow Leopard, the VM's TLS stack usually
# can't reach GitHub directly — download from a modern machine and
# transfer the file.
sudo mv mac-guest-agent /usr/local/bin/
sudo chmod +x /usr/local/bin/mac-guest-agent
sudo /usr/local/bin/mac-guest-agent --install

Download

Single download: mac-guest-agent (i386 + x86_64 + arm64 in one tri-fat Mach-O, covers macOS 10.4 → 26). dyld picks the appropriate slice at load time.

If something goes wrong

Open an issue at https://github.com/mav2287/mac-guest-agent/issues/new with the following (items 1-3 work even when the binary won't launch; 4-6 only if the binary starts):

  1. sw_vers — macOS version
  2. file /usr/local/bin/mac-guest-agent — Mach-O fat header
  3. lipo -info /usr/local/bin/mac-guest-agent — slice list
  4. mac-guest-agent --version
  5. mac-guest-agent --self-test-json — note system_info.selected_arch in the output
  6. tail -50 /var/log/mac-guest-agent.log

Uses ISA serial via Apple's built-in Apple16X50Serial.kext (present since 10.4 Tiger).
No custom kext, no SIP changes, no code signing required.

Assets 4
Loading