react-native run-ios cannot find the iPhone simulator
Could not find iPhone X simulatorShort 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.
Fix it fast
1Find out which cause you have
Let the CLI list the iOS devices and simulators it can use.
npx react-native run-ios --list-devices2Match what you see, then jump to its fix
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-devices2Fix
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
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-devices2Fix
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
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:
- TaxiDexMy own multi-tenant taxi dispatch SaaS: API, dispatcher portal, driver and passenger apps, and the servers underneath.
- QistLockA NestJS and React SaaS driving an Android Device Owner agent that locks financed phones when payments lapse.
- TaskvareA task and project-management suite: React on the web, Flutter on mobile, TypeScript underneath.
Related fixes
Mobile apps
Running pod on a React Native project fails with can't find gem cocoapods
can't find gem cocoapods (>= 0.a) with executable pod
The pod command exists, but the Ruby that is running it has no CocoaPods gem.
3 causes, each with a fixMobile apps
Axios request works on iOS or in a browser but fails on Android with Network Error
AxiosError: Network Error
A React Native app has no CORS, so on Android a Network Error usually means the request never reached the server.
3 causes, each with a fixMobile apps
Axios returns Network Error in a React Native app on iPhone or the iOS Simulator
error.code is ERR_NETWORK and error.response is undefined
A Network Error means iOS stopped the request before any HTTP answer came back.
3 causes, each with a fixMobile apps
backgroundImage: url(...) does nothing in a React Native view
ImageBackground renders an empty area
In React Native the backgroundImage style draws linear and radial gradients, not pictures, so url(...) is ignored.
3 causes, each with a fixMobile apps
A custom font in React Native falls back to the system font
Unrecognized font family 'MyFont'
React Native does not report a missing font, it just draws the system font.
6 causes, each with a fixMobile apps
fetch fails with TypeError: Network request failed in React Native
Network request failed
Network request failed means the request never got an HTTP response, so there is no status code to read.
3 causes, each with a fix