Skip to main content
Developer Mode & Debug Mode on Meta Quest Devices

Steps to enable Developer Mode & Debug Mode on Meta Quest 3, Meta Quest 2 and Meta Quest Pro devices.

Josh Franzen avatar
Written by Josh Franzen
Updated over a week ago

Overview

To set up devices with ArborXR, Meta’s Debug Mode must be enabled, which requires a Meta account that has been added to and verified within a Meta Quest Developer organization. Debug Mode is a setting within the Quest’s Developer Mode and must be enabled and accepted on the Quest device before setting up ArborXR. This knowledge base article details the steps to turn on USB Debugging/Developer Mode so that Debug Mode can likewise be enabled.

📖 If you need help creating a Meta Quest Developer Account and Organization, see our article on How to Set Up a Meta Quest Developer Account and Organization!


Setup your Meta Account on your Quest Device and Enable Debug Mode

💡 If you've already set up your Quest device using the Meta Quest mobile companion app, skip to Step 5.

  1. Download the Meta companion app to your Android or Apple (iOS) mobile phone (available on the Google Play Store or Apple App Store).

  2. Login to the Meta Quest mobile app with the Quest Developer-associated Meta account. If you don't have a Meta Developer Account or Organization already, see this guide to get your Meta account prepared for the steps below.

    1. Select Continue with Facebook or Continue with Instagram if you have linked your Facebook and/or Instagram accounts to your Meta account.

    2. Select Continue with email if your Meta account is unlinked from your Facebook account.

  3. Turn on your Quest headset.

  4. Set up the Quest device with the newly created Meta account (Menu > Devices > Connect new device). Follow any in-app and Quest in-headset instructions.

  5. In the mobile companion app, select Menu in the lower right-hand corner of the bottom navigation menu.

  6. Select Devices.


    💡 While the best practice is to use a unique Meta account per Quest headset, if your organization does not require Quest App Store apps and multiple devices are associated with a single Meta account, a screen with all of the attached Quest devices will appear. Select the desired device in that list (see example below).


  7. Select Headset Settings

  8. Select Developer Mode.

  9. Toggle on the Debug Mode option.

  10. Connect the Quest to your PC via USB.

  11. Put on the headset and within VR you will see the prompt, Accept USB debugging? Select Always allow from this computer (may appear differently in-headset than shown below).

🎉 You've now successfully enabled Debug Mode to allow USB Debugging on your Quest headset. It's ready to add to your ArborXR organization using the Device Setup App. Click here for steps to set up your Quest 2, 3, or Pro devices.


FAQs & Troubleshooting

I don’t see the Debug Mode or Developer Mode toggle for my device in the Meta Quest mobile app. How do I get it to appear?

  • Ensure the same Meta account logged into the Meta Quest Mobile App is the same Meta account used to setup the Quest device in question. In order for Meta’s Debug Mode/Developer Mode to appear in the Meta Quest mobile app, the headset must be set up with the previously set up Quest Developer account.

  • Ensure the Meta account has been added to your team’s Quest Developer organization and verified, either with a credit card or SMS 2FA.

  • If the Meta account was recently verified within your team’s Quest Developer organization, force quit the Meta Quest mobile app and open the app once more.

  • Log out and back into the Meta account on the Meta Quest mobile app.

  • If you have any further challenges with getting the Debug Mode / Developer Mode toggle to appear, reach out to Oculus Developer Support or, alternatively, Meta Support for additional assistance.

I have enabled Debug Mode/Developer Mode in the Meta Quest mobile app, but I’m not seeing the ‘Allow USB Debugging’ prompt inside my headset.

Enabling USB Debugging on Quest devices is required to enroll a device in an MDM, like ArborXR and is a process outside of any MDM's control, including ArborXR. It is dependent on the Quest device and computer establishing a connection first. Our Device Setup App is unable to force the prompt to appear.

The following can help troubleshoot the Allow USB Debugging prompt not appearing as expected (see Step 11 above) if Debug Mode/Developer Mode has been enabled/toggled on in the Meta Quest mobile app:

  • Make sure the Quest device is up to date with the latest Quest OS version.

  • Ensure the device is plugged into both the headset and the computer and that the USB-C cable is properly seated in both the headset and the computer.

  • Restart the device.

  • Toggle the Debug Mode/Developer Mode button off, then back on.

  • Inside the Quest headset, check whether or not that the USB Debugging section is available under Quick Settings > Settings > System > Developer. If it appears, enable it.

  • Switch the orientation of the cable 180 degrees for both the device end and computer end of the cable.

  • Try a different USB-C cable, like the Quest PC Link cable, a different Meta-provided cable, or third-party USB-C cable. The guidance from Meta is to ensure that you are using a high-quality USB-C cable capable of data transfer for connecting your Meta Quest headset to the computer. The cable provided with one of your headsets should suffice.

  • If you’re enrolling multiple devices using a USB hub, disconnect the USB hub and connect a device directly to the computer to rule out an issue with the USB Hub.

  • Ensure your computer’s USB drivers are up to date.

  • Finally, as If you’ve tried all of the above without any resolution, contact Meta Support or search Meta’s Forum’s Get Help section for further assistance.

  • As a last resort, a factory reset may be needed.

Did this answer your question?