How to Fix “Developer Mode disabled” When Running an iPhone App from Xcode

When you try to run a development build on an iPhone from Xcode, you may see Developer Mode disabled and be unable to launch the app on the physical device. Developer Mode was introduced in iOS 16 and is required for common development workflows such as running development-signed apps, debugging, and test automation. This guide explains why the message appears and how to enable Developer Mode safely.

What does “Developer Mode disabled” mean?

This message means Developer Mode is turned off on the connected iPhone, so Xcode cannot use development features that require it. Apple states that Developer Mode is disabled by default and must be explicitly enabled on the device.

Developer Mode disabled

Common situations where it appears

• You are using the iPhone with Xcode for physical-device testing for the first time.
• Developer Mode has never been enabled on the device.
• The device was restored or its settings changed.
• You are trying to run a development-signed app.
• You are attempting to debug or run UI tests on the device.

1. Connect the iPhone to your Mac

Connect the iPhone to the Mac and make sure Xcode recognizes it. A USB connection is the simplest option, although a previously paired device may also work over supported wireless debugging.

If the iPhone asks whether to trust the computer, tap Trust and enter the device passcode if requested.

2. Select the iPhone in Xcode

Open the project in Xcode and choose the connected iPhone as the run destination in the Scheme toolbar. Apple explains that connecting the device to Xcode is what makes the Developer Mode setting available in normal development scenarios.

3. Enable Developer Mode on the iPhone

On the iPhone, open:

Settings → Privacy & Security → Developer Mode

Turn Developer Mode on. The iPhone will ask to restart. After the restart, confirm the prompt on the device to finish enabling Developer Mode.

4. If the Developer Mode option is missing

If Developer Mode does not appear under Settings → Privacy & Security, connect the iPhone to Xcode and make sure Xcode recognizes it as a development device. Then reopen the Settings app.

If the option is still missing, try the following:

• Quit and reopen Xcode.
• Disconnect and reconnect the iPhone.
• Restart both the Mac and iPhone.
• Open Window → Devices and Simulators in Xcode and confirm that the device is listed.
• Check the trust relationship between the iPhone and Mac.

5. Run the app again from Xcode

After Developer Mode is enabled, return to Xcode, select the iPhone as the run destination, and run the app again.

Product → Run

If Developer Mode was the only issue, Xcode should now be able to install and launch the development build on the iPhone.

6. Check Signing & Capabilities if the error continues

If the app still does not run, another configuration problem may remain. Open Target → Signing & Capabilities and check:

• The correct Team is selected.
• The Bundle Identifier is correct.
• Automatically manage signing is configured as intended.
• There are no provisioning profile or signing certificate errors.

Developer Mode allows development features on the device, but it does not correct a signing or provisioning problem.

7. Check Xcode and iOS compatibility

If the iPhone is running a newer iOS release than your installed Xcode version properly supports, you may see separate device or deployment errors even after Developer Mode is enabled. Update Xcode to a version that supports the iOS version on the device when necessary.

Important note

Summary

If Xcode shows “Developer Mode disabled,” connect the iPhone to Xcode, then enable Developer Mode from Settings → Privacy & Security → Developer Mode. Restart the device and complete the confirmation prompt, then run the app again from Xcode.

If the problem remains, check Signing & Capabilities, provisioning, device trust and connectivity, and Xcode/iOS compatibility to identify the next cause.