Skip to content

Run a virtual iPhone on an Apple Silicon Mac.

Swift
14.4 KB
Raw Blame

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.plist has schemaVersion=2. Recreate machines made by earlier releases with vm 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 patch turns 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 prepare refuses a cloudOS that no recipe covers.
  • fw catalog lists 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 standard was checked on 18.6.
  • fw catalog --device iPhone11,6 lists 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-escalator keeps 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 the vphone-escalator allow command that host preflight prints 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.

See also