Develop
Develop
Select your platform

Device Setup

Updated: Oct 1, 2025
This topic shows how to set up a Meta Android device for running, debugging, and testing applications. The currently supported Meta devices that run Android are Meta Quest, Meta Quest 2, Meta Quest Pro, and Meta Quest 3.
Note: To set up an Oculus Rift for development, see the Rift Native SDK documentation.
To begin development locally, you must enable developer mode for the Meta device in the companion app on your mobile phone. Before you can put your device in developer mode, you must belong to (or have created) a developer team on the Meta Horizon Developer Dashboard. If developing on Windows, you will also need to install drivers to use Android Device Bridge (ADB).

Joining or Creating a Team

To join an existing team, follow these steps:
  1. You’ll need to request access to the existing team from the admin.
  2. You’ll receive an email invite. Once accepted, you’ll be a mteam member.
To create a new team, follow these steps:
  1. Go to the Create New Team page of the Meta Horizon Developer Dashboard.
  2. Fill in the appropriate information.

Verify Your Account

Not sure which verification path to choose? Watch this quick clip:
Additionally, you can check out this short video course on Completing Team Verification.
  1. Go to the verification tab of the Meta Horizon Developer Dashboard.
  2. If prompted, login with your Meta Developer account.
  3. Verify your account with one of the two following options:
    • Confirm your mobile number to set up SMS two-factor verification, please visit FB Help Center to ensure that your country and phone carrier are supported for SMS.
    • Add a payment method to your account (Paypal excluded).

Enable Developer Mode

Once you belong to a developer team, follow these steps to put your device in developer mode:
  1. On your mobile device, open the Meta Horizon app.
  2. In the app, tap the hamburger menu (the icon with three horizontal lines) next to the search bar. Then, tap Devices and select your headset from the results.

    Video: Shows selection of the Devices item in the hamburger menu.

  3. Tap Headset Settings beneath the image of your headset.
    Headset settings
  4. Tap Developer Mode.
    Developer mode list item
  5. Turn on the Developer Mode toggle switch.
    Toggle Developer Mode to the on position
  6. Use a USB-C cable to connect the headset to your computer.
  7. Put on the headset.
  8. In the headset, go to Settings > Advanced > Developer, and then enable Enable custom settings and MTP Notification.
  9. When asked to allow USB debugging, select Always allow from this computer.
    Allow USB Debugging prompt
    Allow USB Debugging prompt
Important
Developer Mode is intended for development tasks such as running, debugging and testing applications. Engaging in other activities may result in account limitations, suspension, or termination. For more information, see Content Guidelines.

Install the Oculus ADB Drivers (Windows only)

If you are going to be pushing builds from a Windows machine, you’ll need the Oculus ADB Drivers.
  1. Download the zip file containing the driver.
  2. Unzip the file.
  3. Right-click on the .inf file and select Install.
Once complete, you’ll be able to use Android Debug Bridge (ADB) to push builds to your device.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon