Develop
Develop
Select your platform

Set up your headset for development

Updated: Sep 22, 2025
This topic provides instructions on setting up your Meta Quest headset for development, debugging, and testing.
In this topic, you will do the following:
  • Pair your headset with the Meta Horizon mobile app
  • Install Android Debug Bridge
  • Install Meta Horizon Link
  • Install Meta Quest Developer Hub

Prerequisites

To set up your headset for development and testing, you need the following:

Hardware requirements

  • Development machine running one of the following:
    • Windows 10+ (64-bit)
    • macOS Sierra 10.10+ (x86 or ARM)
  • Supported Meta Quest headsets:
    • Quest 2
    • Quest Pro
    • Quest 3
    • Quest 3S and 3S Xbox Edition
  • Connection between your headset and development machine using one of the following:
    • USB-C data cable (recommended)
    • Wi-Fi connection, with both devices on the same network

Account requirements

Pair your headset with the Meta Horizon mobile app

  1. On your mobile device, open the Meta Horizon app.
    For instructions on installing the Meta Horizon mobile app, see Install the Meta Horizon mobile app on your phone.
  2. Sign in with your Meta developer account credentials through the app.
  3. Pair your headset with the app.
  4. Put on your headset and follow the instructions in the headset to finish the setup.
For detailed setup instructions and troubleshooting, refer to the Getting started with your Meta Quest support page.
  1. On your mobile device, open the Meta Horizon app.
  2. In the app, tap the hamburger menu (three horizontal lines).
    Horizon hamburger menu
  3. Tap Devices under Device management and select your headset from the results.
    Horizon devices menu selection
  4. Tap Headset settings beneath the image of your headset.
    Headset settings
  5. Tap Developer Mode.
    Developer Mode list item
  6. Turn on the Developer Mode toggle switch.
    Toggle Developer Mode to the on position
  7. Use a USB-C cable to connect the headset to your computer.
  8. Put on the headset.
  9. In the headset, go to Settings > Advanced > Developer, and then enable Enable custom settings and MTP Notification.
  10. When asked to allow USB debugging, select Always allow from this computer.
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.
To verify the connection:
  1. Open an existing Unity project.
    You can use the one that you created in Set Up Unity for XR Development.
  2. Navigate to File > Build Settings.
  3. In the Platform list, select Android, and then select Switch Platform. If the target platform is already set to Android, skip to the next step.
  4. In the Run Device list, select the Meta headset. If you don’t see the Meta headset in the list, select Refresh.
  5. Select Build And Run, specify a name and location for the .apk (Android executable) file to output, and select Save to build the app and run it on your headset.
If the app runs successfully on the headset, you have properly connected your device.
After verifying that your device is connected, set up the following tools to assist with connecting, testing, and debugging your device:
  • Android Debug Bridge (ADB) is a command-line tool included with the Android SDK. You can use ADB to install apps and issue other useful commands from the computer.
  • Link is a development tool that enables you to stream applications from your development machine to a Meta Quest headset. With Link, you can significantly decrease XR application development time by launching your app on your headset directly from the Scene view of the Unity Editor, without the need to build and deploy the app for an Android platform.
    Note: Link is currently only supported on Windows. If you are developing on macOS, or developing without access to a headset, use Meta XR Simulator.

Enable Android Debug Bridge

Android Debug Bridge (ADB) is a command-line utility that enables you to perform a number of useful actions during XR development, including:
  • Installing apps to your headset
  • Debugging apps on your headset
  • Copying files to your headset
ADB is included with Unity’s Android SDK tools installation and located inside the /Android/SDK/platform-tools/ folder.
To enable ADB:
  1. Ensure that you have connected the device via USB.
  2. Install the Oculus USB driver.
    Windows: Download the OEM USB driver, extract the oculus-adb-driver-2.0 ZIP file, go to the /oculus-go-adb-driver-2.0/usb_driver/ folder, right-click the android_winusb.inf file, and select Install.
    macOS: Skip to step 3, as you don’t need any additional USB drivers.
  3. Add the installation directory to your system path.
    Windows: If you are using the Android SDK installed with Unity, the installation path should look similar to the following:
     C:\Program Files\Unity\Hub\Editor\<version>\Editor\Data\PlaybackEngines\AndroidPlayer\SDK\platform-tools
    
    macOS: If you are using the Android SDK installed with Unity, the installation path should look similar to the following:
     /Applications/Unity/Hub/Editor/<version>/PlaybackEngines/AndroidPlayer/SDK/platform-tools
    
  4. Open the command line on your development machine and run the following command to check the connected device:
     adb devices
    
    You should see output similar to the following:
     List of devices attached
     1PASH9BB939351	device
    
For additional documentation on using ADB with Meta Quest devices, including manual app installation, additional commands, and troubleshooting, see Android Debug Bridge for Meta Quest.
For more detailed information about using ADB, see Android Debug Bridge in the official Android documentation.
Note: Link is currently only supported on Windows. If you are developing on macOS, or developing without access to a headset, use Meta XR Simulator.
To preview your scene using Link, follow these steps:
  1. Download Link and install the app on your machine.
  2. Put on your headset.
  3. Open the Quick Settings window by selecting the clock on the left side of the menu bar.
  4. Open Settings, select System > Quest Link, and toggle Quest Link on.
  5. Select Launch Quest Link to start Link on your development machine and on your headset.
  6. In your Unity project, press Play(►) to run the app on your headset.
For more details on Link, see Use Link for App Development.

Download and install MQDH

Meta Quest Developer Hub (MQDH) is an application for Windows and MacOS that allows developers to manage their devices, debug their apps, and submit their apps to the Store.
  1. Download and install the Meta Quest Developer Hub application for macOS or Windows.
  2. Open the application and log in using your Meta Developer credentials.
  3. In the left navigation pane, choose Device Manager. All the devices you have set up are displayed in the main pane. Each device is shown with its status, which includes the device ID and connection status. The active device shows a green Active designator.
For more information about MQDH, see Meta Quest Developer Hub Overview.

Learn more

To learn more about Meta Quest device setup and connection, see the following resources:

Next steps

After you set up your Meta Quest device for development, you are ready to Explore Meta Quest Features with Building Blocks.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon