Device Setup

This topic shows how to set up an Oculus Android device for running, debugging, and testing applications. The currently supported Oculus devices that run Android are Oculus Quest and Oculus Quest 2.

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 Oculus 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 organization on the Oculus Dashboard. If developing on Windows, you will also need to install drivers to use Android Device Bridge (ADB).

Joining or Creating an Organization

To join an existing organization, follow these steps:

  1. You’ll need to request access to the existing organization from the admin.
  2. You’ll receive an email invite. Once accepted, you’ll be a member of the organization.

To create a new organization, follow these steps:

  1. Go to https://developer.oculus.com/manage/organizations/create/.
  2. Fill in the appropriate information.

Enable Developer Mode

Once you belong to a developer organization, follow these steps to put your device in developer mode:

  1. Turn on the headset you want to use for development.
  2. Open the Oculus app on your phone and go to Settings.
  3. From the list of devices, tap the device and go to More Settings > Developer Mode.
  4. Slide the Developer Mode toggle.
  5. Connect your headset to the computer using a USB-C cable and wear the headset.
  6. Accept Allow USB Debugging and Always allow from this computer when prompted on the headset.

    Allow USB Debugging prompt

Important

Developer Mode is intended for development activities such as running, debugging and testing applications. Other activities could result in your account being limited, suspended or terminated. For more information, see Oculus Developer 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.