Skip to content
Hoy by Cua

Hoy 0.17.1

Released 17 November 2026. Hoy 0.17.1 is a fix release for 0.17.0, the first public release of Hoy (released 16 November 2026).

Hoy runs macOS virtual machines on Apple silicon Macs, on its own virtual machine monitor built on Apple's Hypervisor.framework.

On an M4 Pro MacBook Pro (macOS 27.2, median of 5 runs), compared with Apple's Virtualization framework on the same Mac: a VM boots to ssh in 5.3 s (6.6 s), a save pauses it for 0.77 s (2.8 s), and a restore has it running again in 1.2 s (3.0 s).

Requirements: an Apple silicon Mac on macOS 26 or 27. No developer tools, and no sudo for the install.

Install: register at hoy.cua.ai and run the install command we email you. The known limits are in the docs; read them first, it takes two minutes.

What's new in 0.17.1

  • The two-macOS-VM limit now recognises Hoy's VM engine by its signature, so a third macOS VM is refused at launch however the engine is started.
  • Already on 0.17.0? Run hoy update. Your VMs and images stay, and running VMs keep running.

Two one-time approvals

Apple's macOS license allows two macOS VMs per Mac. Hoy keeps your Mac within that limit with the Hoy system extension, inside Hoy.app (System Settings lists it as "Hoy"). The installer puts Hoy.app in /Applications and asks macOS to turn the extension on. You finish it with two switches in System Settings:

  1. General > Login Items & Extensions > Endpoint Security Extensions: turn on Hoy.
  2. Privacy & Security > Full Disk Access: turn on com.trycua.hoy.es.systemextension.

The extension turns on by itself a few seconds later. Until both are on, macOS VMs don't start, and hoy doctor says what is missing. Linux VMs and other apps are not affected. Managed Macs can approve both ahead of time with an MDM profile (see the install guide in the docs).

What's in 0.17.0

Running VMs

  • Every VM runs on Hoy's own engine. Apple's Virtualization framework is used only to install macOS from Apple's restore images.
  • The two-VM limit counts macOS VMs from any tool and any user on the Mac. Linux VMs on Apple's Virtualization framework (Docker Desktop, OrbStack, Colima and Lima with vz, UTM's Apple backend) don't count; the Limits page in the docs lists what does. At the limit, hoy start says so and names the VMs that hold it.
  • Snapshots: hoy snapshot, hoy restore and hoy fork. A restore or fork is running in about a second.
  • Each VM gets its own identity (machine identifier and ssh host keys), also after a clone or fork.
  • Hoy notices a booted guest's ssh within a fraction of a second, so a VM is ready to use sooner.

Images

  • hoy image create makes macOS images on your Mac from Apple's restore images: by default the newest macOS 26 or 27 release your Mac supports. Cua does not distribute macOS.
  • hoy import brings in macOS VMs from Tart, UTM (Apple backend) and Lume.

Using VMs

  • hoy vnc <vm> and hoy start --window open a VM's desktop.
  • Clipboard sharing between your Mac and macOS VMs.
  • Sound in macOS guests (hoy set <vm> --audio out).
  • hoy ssh and hoy list.
  • Hoy needs no Local Network access.

Running Hoy

  • hoy update installs a new release with the same checks as the install, and hoy update --rollback goes back. Hoy checks once a day and prints one line when a release is out. Nothing installs by itself unless you turn that on.
  • Hoy starts at login as its own login item, listed as "Hoy" in System Settings.
  • hoy doctor checks the extension, the login item, and free disk space for snapshots of running VMs.
  • hoy-uninstall.sh removes Hoy.app and the extension. macOS asks for an administrator password, so run it from Terminal on the Mac; over ssh it stops before removing anything.

Crash reports and usage data

  • Hoy can send Cua crash reports and basic usage counts. Both are on by default, and each has its own switch: hoy config set crash-reports off, hoy config set usage-data off. DO_NOT_TRACK=1, CUA_TELEMETRY=0 or cua telemetry off turn both off for every Cua program. Turn them off before the first start and nothing is ever sent. hoy config preview usage-data prints exactly what would be sent. Nothing from inside a VM is ever collected. The docs list the exact payloads.

If you ran a preview build (0.16)

  • 0.16 has no hoy update. Run your install command once more; your VMs and images stay, and running VMs keep running. From then on, hoy update works.
  • Approve the extension (the two switches above). Until then, macOS VMs don't start.
  • VMs made on the old vz engine stay listed but can't start. Create a new VM from an image (hoy create <name> --image <ref>), then hoy rm the old one.
  • Removed: --engine vz, "defaultEngine": "vz" in hoyd.json, and hoy create --from-lume (use hoy import lume).

Known limits

Apple Account, iCloud and App Store sign-in don't work in guests yet. Under heavy graphics load, a guest's frame rate is lower than with Apple's own framework. The full list is in the docs.

Hoy is closed source. It's signed with Developer ID (Cua AI, Inc.) and notarized by Apple, and the installer checks both before it installs anything. Hoy is licensed under the Hoy End User License Agreement. Free, including commercial use.

Help