Skip to content

Developer Setup

For the fastest and most stable development experience, you can connect your Meta Quest headset directly to your computer via USB and use port forwarding. This allows the headset to access your local development server directly.

Requirements

  1. Developer Mode: Ensure Developer Mode is enabled on your Meta Quest headset.
  2. Meta Quest Developer Hub (MQDH): Download and install MQDH on your development computer.
  3. USB3 Cable: You'll need a compatible USB3 cable to connect your headset to your computer.

Setup

1. Connect Your Headset

Connect your Quest to your computer with the USB-C cable. Inside the headset, you may see a prompt to "Allow USB debugging." Be sure to "Allow" it.

2. Start the Dev Server

In your project's terminal, start the local development server as usual

npm run dev

This will typically run the project on http://localhost:5173.

3. Configure Port Forwarding in Chrome

Open Google Chrome on your computer and navigate to chrome://inspect/#devices.

  • Select the "Port forwarding" tab.
  • Configure a new rule:
  • Port: 5173
  • IP address and port: localhost:5173

Make sure the Enable port forwarding checkbox is checked

Port Forwarding Chrome Screenshot

Launch in Headset

  • Copy and paste localhost:5173 into the MQDH and click Open or in the Quest Browsers address bar, simply type localhost:5173 and press enter.
  • Your app will now open in the Meta Quest Browser.

Meta Quest Developer Hub

Meta Quest Browser Developer Console

To view the Meta Quest Developer Console, your application must be running in the Meta Quest Browser. Once the page is active, an Inspect link will appear below your device name in chrome://inspect/#devices.

Meta Quest Browser Console

intercom If you have a question or any feedback about our documentation please use the Intercom button (purple circle) in the lower right corner of any web page or join our Discord.