Hoy 0.17.0
Released 16 November 2026. This is the first public release of Hoy.
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.
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:
- General > Login Items & Extensions > Endpoint Security Extensions: turn on Hoy.
- 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 this release
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 startsays so and names the VMs that hold it. - Snapshots:
hoy snapshot,hoy restoreandhoy 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 createmakes macOS images on your Mac from Apple's restore images (macOS 26.5.2 and 27.2.1). Cua does not distribute macOS.hoy importbrings in macOS VMs from Tart, UTM (Apple backend) and Lume.
Using VMs
hoy vnc <vm>andhoy start --windowopen a VM's desktop.- Clipboard sharing between your Mac and macOS VMs.
- Sound in macOS guests (
hoy set <vm> --audio out). hoy sshandhoy list.- Hoy needs no Local Network access.
Running Hoy
hoy updateinstalls a new release with the same checks as the install, andhoy update --rollbackgoes 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 doctorchecks the extension, the login item, and free disk space for snapshots of running VMs.hoy-uninstall.shremoves 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=0orcua telemetry offturn both off for every Cua program. Turn them off before the first start and nothing is ever sent.hoy config preview usage-dataprints 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 updateworks. - 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>), thenhoy rmthe old one. - Removed:
--engine vz,"defaultEngine": "vz"in hoyd.json, andhoy create --from-lume(usehoy 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
- Docs: cua.ai/docs/hoy
- Bugs: github.com/trycua/cua/issues
- Security: support@trycua.com, with "Hoy security" in the subject. Please don't post security reports in public.
- Anything else: hoy@cua.ai