Develop
Develop
Select your platform

Configure your headset for app development

Updated: Oct 1, 2025
In addition to installing and configuring the development environment on your computer, you also need to configure your headset.
To develop apps, you need the following VR hardware:
  • A headset that matches the device that you’re targeting
  • A pair of controllers for the device
  • A USB-C cable for a Link connection
For a full list of prerequisites, see Prerequisites.

Prepare your headset for use

There are four steps to prepare your headset for use:
  1. Download and install the Meta Horizon OS mobile app for your phone in order to set up your headset. You can this directly to your mobile device using either Google Play or the Apple Store.
    Note: The mobile app is the same for all Meta Horizon OS headsets, including all Meta Quest series headsets and the Oculus Rift S.
  2. Download the Meta Horizon Link app from the Get Started in VR page. For installation instructions and more information, see Using Link for App Development.
  3. Set up your headset following the instructions for the device your app is targeting:
    • For Meta Quest 3, follow the headset setup instructions at Setting Up Your Meta Quest.
    • For other headsets, including the Oculus Rift S, follow the setup instructions for your specific headset.
Once you have set up your headset, sign in to your verified developer account on both the headset and mobile app.

Configure your headset for deployment and debugging

Once you have completed the headset’s initial setup and joined a team, you are ready to configure your hardware to allow you to deploy and debug your first Meta Quest app.
This entails three steps:
  1. Enable developer mode for your headset.
  2. Set Up Meta Quest Developer Hub.
  3. Enable apps from unknown sources.

Switch your headset to developer mode

Before creating an app with your headset, you must enable developer mode.
To enable developer mode for your headset:
  1. In the Meta Horizon OS mobile app, go to the Menu tab and choose Devices.
  2. Select your headset from the list, then go to Headset Settings > Developer Mode.
  3. Turn on the Developer Mode option.
  4. Connect the headset to your computer with a USB-C cable and put the headset on again.
  5. When prompted, select Always allow from this computer to enable USB debugging.

Connect your headset to the Meta Quest Developer Hub

The Meta Quest Developer Hub (MQDH) is a standalone companion development tool that simplifies integrating the headset into your development workflow. Meta recommends using this while developing your app in Unreal Engine for Meta Horizon OS. For installation instructions, see MQDH Set Up.

Enable apps from unknown sources

There are two main reasons where you might need to enable apps from unknown sources: running content from developers that isn’t available in the Meta Horizon Store, and running applications that are under development.
Note: Meta hasn’t reviewed this content for security, comfort, content, or health and safety.
Although Meta doesn’t review this content, you can run it on your headset if developers permit it.This is necessary to run applications under development, since they are not yet available on the Meta Horizon Store.
To enable your system to run applications from unknown sources:
  1. Open the Link app on your PC.
  2. Select Settings in the left menu, and then select the General tab.
  3. Turn on Unknown Sources to allow content from unknown sources.
The first time you run an application that was not downloaded from the Store, you need to launch it directly. After running an application from an unknown source once, it will appear in the Library section of your Home screen. You can then launch the app normally from there, provided Unknown Sources remains enabled.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon