Run a virtual iPhone on an Apple Silicon Mac.
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
/productvalues 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 thedevicetree-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.