Skip to content

Run a virtual iPhone on an Apple Silicon Mac.

Swift
3.7 KB
Raw Blame

Other iPhone models

How to run a guest whose iOS comes from another iPhone's restore IPSW instead of the iPhone17,3's (iPhone 16). Use it when you need a specific model's userland, panel size or identity.

The virtual hardware stays the same, as with an iPad guest: the boot chain, kernel, SEP and device tree still come from the PCC cloudOS IPSW (vresearch101ap / vphone600ap). Only the userland comes from the chosen model's IPSW, and the device tree the guest boots is rewritten to present that model.

Create one

In Launchpad, choose New Machine, pick the model under Device and a release under iOS.

From a terminal, through Launchpad:

vphone-launchpad-cli vm create iphone17pro --device iPhone18,1

With vphone-cli, pass the model's IPSW and the cloudOS:

vphone-cli vm create iphone17pro \
  --iphone-source 'https://updates.cdn-apple.com/2026SummerFCS/f768ecdf-e037-44e6-bfa6-949b6d127c4f/iPhone18,1_26.6.2_23G90_Restore.ipsw' \
  --cloudos-source 'https://updates.cdn-apple.com/private-cloud-compute/c0ecdb4b310cf5239ab2b248dd3098eec297dc5aa3bbe6ada27273262b0b8b64'

Each iPhone model has an IPSW of its own, so --device is not needed with explicit sources.

To find a release, run fw catalog. It lists the iPhone 16 and 17 models' releases from 26.0 to 27.0.1 (the iPhone 17e from 26.3.1) and the iPhone 18 Pro's 27.0.1, each with the cloudOS an iPhone17,3 of that release uses. To list one model's releases:

vphone-cli fw catalog --device iPhone18,1

Supported devices

Product Model Board Panel Points @3x
iPhone17,3 iPhone 16 D47AP 1290x2796 @ 460 ppi 430x932
iPhone17,4 iPhone 16 Plus D48AP 1290x2796 @ 460 ppi 430x932
iPhone17,1 iPhone 16 Pro D93AP 1206x2622 @ 460 ppi 402x874
iPhone17,2 iPhone 16 Pro Max D94AP 1320x2868 @ 460 ppi 440x956
iPhone17,5 iPhone 16e V59AP 1170x2532 @ 460 ppi 390x844
iPhone18,3 iPhone 17 V57AP 1206x2622 @ 460 ppi 402x874
iPhone18,4 iPhone Air D23AP 1260x2736 @ 460 ppi 420x912
iPhone18,1 iPhone 17 Pro V53AP 1206x2622 @ 460 ppi 402x874
iPhone18,2 iPhone 17 Pro Max V54AP 1320x2868 @ 460 ppi 440x956
iPhone18,5 iPhone 17e V159AP 1170x2532 @ 460 ppi 390x844
iPhone19,2 iPhone 18 Pro V63AP 1206x2622 @ 460 ppi 402x874

Every model, the iPhone17,3 included, gets its panel and identity from its own device tree; the iPhone17,3's panel is the display it has always had.

The iPhone 17 Pro, 17 Pro Max and 18 Pro have recorded boot validation; see Compatibility. The iPhone 17 Pro and 17 Pro Max need a patch on iOS 27, described there.

[!WARNING] iPhone19,2 uses ARM64E_X1. On hosts without native X1 support, the standard preset lowers the unsupported instructions, which weakens PC-bound pointer authentication.

What changes for another iPhone

Everything listed under What changes for an iPad applies, with two differences:

  • The board's /product values replace the vphone600 placeholders the same way, but an iPhone board keeps its phone properties: Dynamic Island, reachability, OLED, volume-button geometry, CarPlay and Watch pairing come from the board instead of being removed. The patch IDs are the devicetree-cfw-ipad_* ones; they were named before iPhones used them.
  • LLB is not patched for the display scale. The paravirtual display's boot video word says 3x, which is already an iPhone's scale.

See also