Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Flutter and app store releases

react-native run-ios cannot find the iPhone simulator

ErrorCould not find iPhone X simulator

Short answer

run-ios starts a default simulator by name. If that model is not installed in Xcode, it tries a short list of fallbacks and then gives up. Choose a simulator you actually have: list them with --list-devices, or name one with --simulator, adding the iOS version in parentheses when several share a name.

  • Applies to React Native CLI, Xcode 26
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 1Find out which cause you have

    Let the CLI list the iOS devices and simulators it can use.

    npx react-native run-ios --list-devices
  2. 2Match what you see, then jump to its fix

    1. 1The message names a model you never createdThe default simulator is not installedFix
    2. 2The right model exists but under a different runtimeThe name matches several simulators or the wrong iOS versionFix

What does the error look like?

  • Could not find iPhone X simulator

Cause 1 of 2

The default simulator is not installed

1Check

Per the CLI documentation, without --simulator it targets a default model and falls back through a fixed list of older iPhones if that is missing. On a recent Xcode none of them may exist.

npx react-native run-ios --list-devices

2Fix

Run with the exact name of a simulator from the list.

npx react-native run-ios --simulator "iPhone 16"

3Verify

The simulator boots and the app opens.

npx react-native run-ios --simulator "iPhone 16"

Confirmed by raw.githubusercontent.com

Did this fix it?

Cause 2 of 2

The name matches several simulators or the wrong iOS version

1Check

The CLI lets you add the OS version in parentheses to the simulator name to match exactly, and --udid selects by unique ID.

npx react-native run-ios --list-devices

2Fix

Pass the name with its version, or the UDID of the one you want.

npx react-native run-ios --simulator "iPhone 16 (18.0)"
npx react-native run-ios --udid <udid-from-list>

3Verify

The chosen simulator boots.

npx react-native run-ios --udid <udid-from-list>

Confirmed by raw.githubusercontent.com

Did this fix it?

How do I stop it coming back?

  • Pass --simulator in your package.json script so it does not depend on a default.
  • Install the simulator runtimes you need in Xcode > Settings > Components.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.

Which stack is behind this page?

Projects of mine built on the same technologies:

Related fixes

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.