Background
When enrolling Meta devices in ManageXR through Meta Horizon managed services, you have two options:
Enroll devices through the Meta Admin Center (work.meta.com) - More suitable for small deployments. The setup process requires the user to don the headset in order to complete several in-headset steps.
Or
Enroll devices through Meta’s Device Setup App - More suitable for large deployments provisioning devices in-bulk. The setup process only includes a single in-headset step.
This help doc covers how to properly enroll devices into ManageXR through Meta’s Device Setup App.
Prerequisites & Compatibility
Supported Hardware/OS: Quest devices running firmware ≥ v78
Required Software Versions:
Meta Device Setup App ( v1.16.0 or later)
Download in your Meta Admin Center
ManageXR Device Setup Tool ( 2.0.14 or later)
Download for Windows
On windows, the Device Setup Tool will download as a zip folder. Unzip the folder and launch the ManageXRDeviceSetupTool.exe. After launching, you may get a Windows protected your PC popup. Click More info, and then select Run anyway.
Network Requirements: Wi-Fi SSID/password
Process Overview
The bulk enrollment process requires both the Meta Device Setup App and the ManageXR Device Setup Tool. The Meta Device Setup App is used to enroll your devices in HMS and ManageXR. The ManageXR Device Setup Tool is then used to grant required permissions to ManageXR to run properly (which are normally granted by a user in-headset when enrolling devices through the Meta Admin Center). The ManageXR Device Setup Tool can also be used to efficiently push apps and files onto devices over the wire, instead of waiting for devices to download content over wi-fi.
It is important to complete all of the steps in each phase of the process:
Phase 1: Prepare for Enrollment
Download the required software
ManageXR Device Setup Tool
On windows, the Device Setup Tool will download as a zip folder. Unzip the folder and launch the ManageXRDeviceSetupTool.exe. After launching, you may get a Windows protected your PC popup. Click More info, and then select Run anyway.
Meta Device Setup App
In your Meta Admin Center, go to Managed Devices > Enroll devices > In the Device Setup App to download
Create a Third-party MDM enrollment for ManageXR in your Meta Admin Center
Download your enrollment token from ManageXR. Learn More
Open your Meta Admin Center
Go to Third-party MDMs
Click Create third-party enrollment
Give it a name
Upload your enrollment token json
Finish creating the enrollment
Prepare the Meta Device Setup App
Open the Meta Device Setup App on your computer
Click Select device configuration to select the correct device configuration
Add your provisioning wi-fi network - this is required!
Click the “...” button in the bottom left
Click Settings
Enter your network SSID/Password in the Network section
Click Save
Phase 2: Enroll Devices
Factory reset the headset
If previously enrolled, remove it from both ManageXR and Meta’s Admin Center
To factory reset, simply hold down the power button and volume down button simultaneously. After a period of time, you will get a popup menu. Using the volume buttons and power button as a selector, navigate to the Factory reset option and select this.
Enter Fastboot mode
To begin, power off your factory reset device.
Press and hold the volume down button
When your device shows the screen below, release the volume down button. This is fastboot mode:
Connect your device to your computer using a USB-C cable
Note, you can use a cable splitter to connect multiple devices at once!
Click Enroll in the Meta Device Setup App
Allow USB debugging in-headset when the device gets to the “Configuring MDM: Provisioning” status shown in the Device Setup App
Put on the device
Click Always allow USB debugging from this computer
This is the only manual step in-headset!
Wait for enrollment to complete in the Meta Device Setup App
Wait for the device to reboot into Shared Mode
Phase 3: Grant required permissions with ManageXR Device Setup Tool
After the device has rebooted into Shared Mode, open the ManageXR Device Setup Tool
Click the Grant Permissions button on the ManageXR Device Setup Tool
Congratulations! Your device is enrolled in ManageXR and is ready to use!
Validation & QA
To confirm that your device is enrolled in ManageXR with the correct permissions:
Verify that ManageXR is installed in the Device Setup Tool:
Note! You should no longer see a warning about Missing Permissions. If you do, follow the steps in Phase 3 to Grant Permissions.
Seeing this Installed status with no error messaging on the Device Setup Tool means that you're in good shape! If you want extra validation, proceed to steps 2-4:
Click Go to MXR to open the device detail page on the ManageXR Web Console
Go to the Device Information tab. Confirm the device has communicated with ManageXR by checking when it last synced:
If you see "Last synced never" instead of a recent timestamp, go into the headset and connect it to Wi-Fi. Then, confirm the device comes online and syncs with ManageXR.
If it is important that all apps and files are installed at this stage, verify that the device shows Up to Date.
Scroll down to find Android Permissions on the bottom right and confirm there is a check next to:
✅ Android OBB Permission
✅ App Usage Stats Permission
✅ Skip Streaming Prompt Permission
Optional: Push Configuration over USB
To efficiently load content like large apps and files onto devices, you can use the ManageXR Device Setup Tool’s Push Configuration Update command. This command will download the contents of the configuration onto your computer, cache them, then load them over the wire onto devices. Using Push Configuration Update will speed up provisioning and save bandwidth because you only download content once to your computer, rather than downloading it individually on each device over wi-fi.
Need more help?
Talk to a member of our team using the chat bubble in the bottom right of your screen, or reach out to support@managexr.com