Run a virtual iPhone on an Apple Silicon Mac.
Firmware compatibility
Which guest firmware and cloudOS pairings are known to boot, on which hosts. Check it before you pick a release for a new machine, or when a creation fails and you want to know whether the pairing was ever tested.
To see what the current catalog offers on your Mac, run:
vphone-cli fw catalog
[!NOTE] Since v2.0.0, vphone starts only machines whose
config.plisthasschemaVersion=2. Recreate machines made by earlier releases withvm create; there is no in-place upgrade. The results below describe tested pairings, not compatibility with older machine bundles.
Tested Environments
These are the iPhone17,3 combinations run end to end with the native JB pipeline. The two PR #486 rows (PR #486) reached the lock screen and answered a vphoned ping; a fresh 26.6.2 vm create also completed every stage and exited successfully after its first-boot ping.
| Validation | iPhone restore IPSW | PCC/cloudOS IPSW | Observed result |
|---|---|---|---|
| PR #486 | 17,3_26.6.2_23G90 |
26.4-23E5207q |
JB patches, restore, CFW, boot, vphoned ping |
| PR #486 | 17,3_27.0_24A435 |
26.4-23E5207q |
JB patches, restore, CFW, boot, vphoned ping |
| Research board | 17,3_26.6_23G71 |
26.6-23G71 |
standard and Minimal presets from the CLI, standard from Launchpad (2026-10-20): converted device tree and SEP, kernelcache mix, restore, CFW, boot, vphoned ping |
| Research board | 17,3_26.5_23F77 |
26.5-23F75 |
standard preset from the CLI (2026-10-20): GPU driver from a temporary cloudOS restore, kernelcache mix, restore, CFW, boot, vphoned ping |
| Research board | 17,3_26.4_23E246 |
26.4-23E244 |
standard preset from the CLI (2026-10-20): GPU driver from a temporary cloudOS restore, kernelcache mix, restore, CFW, boot, vphoned ping |
| Research board | Watch7,18_26.4_23T240 |
26.4-23E244 |
watchos preset from the CLI and from Launchpad (2026-10-20): watch kernelcache mix, restore, boot, vphoned ping |
| Research board | 11,6_18.7.2_22H124 |
18.7.2-22H43 |
Minimal preset from the CLI (2026-10-21): GPU driver from a temporary cloudOS restore, iOS 18 kernelcache mix linked over ssh by the kmutil of macOS 15.6.1, restore, boot, vphoned ping; screen, lock screen, unlock and home swipes checked |
| Research board | 11,6_18.1_22B83 |
18.1-22B83 |
Minimal preset from the CLI (2026-10-21): GPU driver from a temporary cloudOS restore, kernelcache mix linked over ssh by the kmutil of macOS 15.6.1, restore, boot, vphoned; Hello screen, lock screen, unlock and home swipes checked |
| Research board | 11,6_18.5_22F76 |
18.5-22F76 |
Minimal preset from the CLI (2026-10-21): GPU driver from a temporary cloudOS restore, kernelcache mix linked over ssh by the kmutil of macOS 15.6.1, restore, boot, vphoned; lock screen, unlock and home swipes checked |
| Research board | 11,6_18.6_22G86 |
18.6-22G86 |
standard preset from Launchpad's CLI (2026-10-24): kernelcache mix (cached), restore, CFW, boot, vphoned, Hello screen; Frida 17.24.3 attach, spawn, Interceptor and Stalker with the two Frida patches allowed |
Which cloudOS to use
Use the cloudOS 26.4 beta (26.4-23E5207q) unless you have a reason not to. It is the newest cloudOS that contains vphone600ap, the identity the guest's kernel, SEP and device tree come from, and it needs nothing beyond vphone-cli.
Every later cloudOS (checked on 2026-10-03) lists only the PCC boards and vresearch101ap: iPhone99,11 is gone from SupportedProductTypes, and there is no kernelcache.*.vphone600, sep-firmware.vphone600 or DeviceTree.vphone600ap. On such a cloudOS the research board stands in (the Research Board patch set):
fw patchturns the research board's device tree and SEP into vphone600's and rebuilds its kernelcache with the vphone600 virtualization kexts, from a recipe for that kernelcache.- KDK extraction is native; only the link needs root (
vphone-cli fw kernelcache). See the kernelcache recipes and Firmware preparation. fw preparerefuses a cloudOS that no recipe covers.fw cataloglists each iOS release's own cloudOS beside the recommended one, and Launchpad offers it under Firmware.
| cloudOS | vresearch101ap |
vphone600ap |
kernelcache recipe |
|---|---|---|---|
26.4-23E5207q (beta) |
yes | yes | not needed |
26.4-23E244 |
yes | no | yes |
26.4.1-23E254 |
yes | no | no |
26.5-23F75 |
yes | no | yes |
26.5.2-23F83 |
yes | no | no |
26.6-23G71 |
yes | no | yes |
26.6.1-23G82 |
yes | no | no |
26.7-23H20 |
yes | no | yes |
Other iPhone and iPad versions may work with 26.4-23E5207q, but they have not passed the same end-to-end check.
iOS 18 guests
iOS 18.1 to 18.7.2 run on their own release's cloudOS, with the userland of the iPhone XS family's IPSWs:
- Create them with
vm create --device iPhone11,6. The Minimal preset is the default;--preset standardwas checked on 18.6. fw catalog --device iPhone11,6lists the releases.- Their kernels are kernel-first. From macOS 26.4 on, another Mac or a macOS VM running macOS 15 or 26.0 to 26.3 links the mix over ssh (
VPHONE_KMUTIL_SSH; see Firmware preparation). - Launchpad offers them as the iPhone XS Max, with that Mac as the macOS builder.
18.1, 18.5 and 18.7.2 are checked on VMs; the other four recipes have not been booted yet.
iPhone17,3 on iOS 27.0.1
iOS 27.0.1 (24A446) fails first boot on bundle 2.5.0 and earlier (reproduced 2026-10-04, also with the pristine Apple launchd): TXM's selector-24 pre-check rejects every binary at init, and the boot panics with unexpected SIGKILL of init. The txm-boot-precheck_admission patch fixes it (see the research note). With the patch, iPhone17,3 27.0.1 on 26.4-23E5207q boots to the guest and answers a vphoned device.info (verified the same day). Bundle 2.6.0 is the first release that carries it.
macOS 26.6.2 hosts
Checked on 2026-10-23 with Core Bundle 2.12.1, and again on 2026-10-24 with Core Bundle 2.12.2, on Mac mini M4 hosts (Mac16,10, 16 GB, macOS 26.6.2 25G83). Every machine was created from nothing, from the CLI. The research-board pairings staged their kernelcache mix as the user and linked it with sudo, then ran sudo vphone-cli vm create. "Default" marks the newest pairing fw catalog gives that device on this Mac, which is what Launchpad's New Machine selects. Each machine then booted twice headless: vphoned answered, device.info reported the release, and the guest's serial log showed no panic.
| Guest | Firmware | cloudOS | Result |
|---|---|---|---|
| iPhone17,3 | iOS 27.0.1 (default) | 26.4-23E5207q |
template build, clone, two boots |
| iPhone18,2 | iOS 27.0.1 (default) | 26.4-23E5207q |
template build, clone, two boots |
| iPad16,1 | iPadOS 27.0.1 (default) | 26.4-23E5207q |
template build, clone, two boots |
| iPhone17,3 | iOS 26.6.2 | 26.4-23E5207q |
template build, clone, two boots |
| iPhone17,3 | iOS 26.6.2 | 26.6-23G71 |
research board: native KDK extraction, macOS 26 link with no auth stubs left, 28 kernelcache patches, two boots |
| iPhone17,3 | iOS 26.5 | 26.5-23F75 |
research board, as above |
| iPhone17,3 | iOS 26.4 | 26.4-23E244 |
research board, as above |
| iPhone17,3 | iOS 18.6.2 | 26.1-23B85 |
template build, clone, two boots |
| iPhone11,6 | iOS 18.7.2 (default) | 18.7.2-22H43 |
Minimal, mix linked over ssh by the kmutil of a macOS 15.7.7 VM, two boots |
| iPhone11,6 | iOS 18.6 | 18.6-22G86 |
as above: the first boot of this recipe |
| iPhone11,6 | iOS 18.7 | 18.7-22H20 |
as above: the first boot of this recipe |
| Watch7,18 | watchOS 26.4 (default) | 26.4-23E244 |
watchos preset, watch kernelcache mix, two boots |
| AppleTV5,3 | tvOS 26.6 (default) | 26.4-23E5207q |
tvos preset, two boots |
| AppleTV14,1 | tvOS 26.6 (default on macOS 26) | 26.4-23E5207q |
tvos-4k preset, 26.6 OTA userland, two boots |
| AudioAccessory5,1 | HomePod Software 27.0 (default on macOS 26) | 26.4-23E5207q |
homepod-mini preset, two boots |
| AppleTV14,1 | tvOS 27.0 | — | refused before any download: needs macOS 27 |
| AudioAccessory5,1 | HomePod Software 27.2 | — | refused before any download: needs macOS 27 |
The tvOS 27.0 (24J361) and HomePod Software 27.2 (24K120) OTAs compress their payload with LZRAVEN, which only macOS 27 unpacks. On an older Mac, fw catalog leaves them out, so Launchpad's default for those devices is tvOS 26.6 and HomePod Software 27.0, and naming one of them is refused before anything is downloaded.
Apple TV 4K (4th generation), AppleTV18,1 / J265AP, is available for bring-up only, with tvOS 27.2 beta (24K120): its full OTA over the Apple TV HD 26.6 restore base and cloudOS 26.4 beta (23E5207q). It requires macOS 27 and the tvos-4k preset. On 2026-10-24 one machine was restored, had its custom firmware installed, and cold booted twice to vphoned and the 4K Language screen of the legacy TVSetup; setup itself was not completed. It is not in the tested table above. See the bring-up notes.
cloudOS 26.7 (23H20) has no iPhone release to pair with. Staged with iOS 26.6.2's userland, its mix links and its 28 kernelcache patches apply, but the CFW patch _vm_fault_enter_prepare finds no site in that kernel. It has not booted.
[!TIP]
vphone-escalatorkeeps its allowlist in amfid's memory, so the allowlist is lost when amfid restarts, as happened once on these hosts mid-run. Launchpad allows the bundle again when AMFI refuses it. From the CLI, run thevphone-escalator allowcommand thathost preflightprints again.
Other iPhone models
Models other than iPhone17,3 are described in Other iPhone models.
| Host | iPhone restore IPSW | PCC/cloudOS IPSW | Observed result |
|---|---|---|---|
| Mac17,9 (M5 Pro) 27.0.1 | 18,1_26.6.2_23G90 (iPhone 17 Pro) |
26.4-23E5207q |
Launchpad vm create (2.5.1 local bundle): prepare, patch, restore, CFW, boot to the home screen at 402x874 pt @3x, model iPhone18,1, vphoned ping |
| Mac17,9 (M5 Pro) 27.0.1 | 18,2_27.0.1_24A446 (iPhone 17 Pro Max) |
26.4-23E5207q |
boots with the kernel-boot-shared_region_size patch (2026-10-06, bundle 2.6.0-local.0d5e6f90): dyld cache mapped system-wide, 0 panics, vphoned answers as 27.0.1, home screen at 440x956 pt @3x |
| Mac17,7 (M5 Max) 26.4 | 19,2_27.0.1_24A446 (iPhone 18 Pro) |
26.4-23E5207q |
boots with integrated ARM64E_X1 compatibility (2026-10-17): clean offline restore, validated root seal, vphoned ping, and Settings, Safari and Calculator launch |
iPhone18,1 and iPhone18,2 on iOS 27
These need the kernel-boot-shared_region_size patch (issue #596, 27.0 and 27.0.1). It is on in the standard preset for an iOS 27 base since 2026-10-06.
Their dyld shared cache records a sharedRegionSize of 0x185804000 on 27.0.1, larger than the 0x180000000 shared region of the cloudOS 26.4 guest kernel, so the cache cannot map even with dyld-boot-maxslide taking its slide away. Without the patch, launchd panics on first boot with Library not loaded: /usr/lib/libSystem.B.dylib. iPhone17,3's 27.0.1 cache (0x17D508000) still fits.
The patch widens the arm64 region to 0x1C0000000, the largest size that stays under the 26.4 kernel's own task-map ceilings. When the machine's kernel carries the patch (its PatchReceipt.plist says so), cfw install measures the cache against the widened region, so these devices install and boot; this was validated on iPhone18,2 27.0.1 as above.
Without the patch (an older bundle, or the patch unticked), cfw install refuses such a cache with this explanation instead of leaving a guest that panics. Use iPhone17,3 for iOS 27, or iOS 26 on these devices.
iPadOS
iPad guests are described in iPadOS guests.
| Host | iPad restore IPSW | PCC/cloudOS IPSW | Observed result |
|---|---|---|---|
| Mac17,9 (M5 Pro) 27.0.1 | iPad16,1,iPad16,2_26.6.2_23G90 |
26.4-23E5207q |
prepare, patch, restore, CFW (2.2.5 helper), boot to the iPadOS home screen at 744x1133 pt @2x, model iPad16,1, vphoned ping |
| Mac17,9 (M5 Pro) 27.0.1 | iPad16,1,iPad16,2_27.0.1_24A446 |
26.4-23E5207q |
Launchpad vm create --device iPad16,1 from the catalog (2.4.0 bundle): prepare, patch, restore, CFW, boot to the iPadOS home screen at 744x1133 pt @2x, model iPad16,1, ios_version 27.0.1, vphoned ping |
Earlier reported combinations
An earlier README recorded these host and firmware pairings. They predate the current single-mode flow or lack the same vphoned acceptance evidence, so treat them as research history, not as the current support matrix.
| Host | iPhone | CloudOS |
|---|---|---|
| Mac16,11 27.0b2 | 17,3_18.6.2_22G100 |
26.1-23B85 |
| Mac16,8 26.5.1 | 17,3_26.0_23A341 |
26.1-23B85 |
| Mac16,8 26.5.1 | 17,3_26.0.1_23A355 |
26.1-23B85 |
| Mac16,12 26.3 | 17,3_26.1_23B85 |
26.1-23B85 |
| Mac16,12 26.3 | 17,3_26.3_23D127 |
26.1-23B85 |
| Mac16,12 26.3 | 17,3_26.3_23D127 |
26.3-23D128 |
| Mac16,12 26.3 | 17,3_26.3.1_23D8133 |
26.3-23D128 |
| Mac16,11 26.2 | 17,3_26.4_23E246 |
26.4-23E5207q |
| Mac16,11 26.2 | 17,3_26.5_23F77 |
26.4-23E5207q |
| Mac16,11 27.0b2 | 17,3_26.5.2_23F84 |
26.4-23E5207q |
| Mac16,6 26.4.1 | 17,3_26.6_23G71 |
26.4-23E5207q |
| Mac16,11 27.0b2 | 17,3_26.6.1_23G83 |
26.4-23E5207q |
| Mac16,6 26.6.1 | 17,3_26.6.2_23G90 |
26.4-23E5207q |
| Mac16,11 27.0b2 | 17,3_27.0_24A5380h |
26.4-23E5207q |
| Mac16,6 26.4.1 | 17,3_27.0_24A5390f |
26.4-23E5207q |
| Mac16,6 26.6.1 | 17,3_27.0_24A5408d |
26.4-23E5207q |
| Mac16,11 27.0b2 | 17,3_27.0_24A5418b |
26.4-23E5207q |
| Mac16,11 27.0b2 | 17,3_27.0_24A5424a |
26.4-23E5207q |
| Mac16,11 27.0b2 | 17,3_27.0_24A5430a |
26.4-23E5207q |
| Mac16,6 26.6.1 | 17,3_27.0_24A435 |
26.4-23E5207q |
For the full list of patches and where each applies, see the patch inventory.