Meta offers a Device Setup App that allows you to enroll devices in management while skipping most of the in-headset steps. We’re working on integrating this with ManageXR to provide a more seamless and efficient experience for provisioning devices in bulk. Today, we have a beta version of the experience available.
After one-time preparation described below, the bulk device enrollment process is:
Use Meta Device Setup App (DSA) to enroll device in MHMS and ManageXR
Grant USB debugging access in-headset
Switch to ManageXR Device Setup Tool
Use Push Configuration Update action to load content, wi-fi, settings, and grant required permissions
One-time preparation
Step 1: Download the ManageXR Device Setup Tool (Special Early Access Version)
Use the special build below (includes changes specific to this project). This version will be published to production soon.
ManageXR Device Setup Tool
Mac: Download for Mac
Windows: Download for Windows
Step 2: Confirm your default configuration on ManageXR has USB debugging enabled
Turning on USB debugging allows your device to connect to the Device Setup Tool to download apps, files, wi-fi credentials etc. in step #6.
You can turn this off after provisioning is complete.
Step 3: Download your Organization Enrollment Token (JSON) from ManageXR
Download your organization enrollment token from your ManageXR organization
Ensure your ManageXR organization is using a Default Configuration (not Configuration Code) under Add Device > Meta > Enrollment Configuration Assignment
⚠️ Note: You cannot choose Configuration Code for your Enrollment Configuration Assignment when using Meta's Device Setup App. Configuration Code will trigger an in-headset prompt during enrollment, which will block Meta’s Device Setup App from proceeding automatically.
Step 4: Update the Admin App URL in the Enrollment JSON
Replace the Admin App download location URL in your organization enrollment token JSON with the following:
New URL:
Step 5: Create New Enrollment in MHMS
In MHMS > 3rd Party MDMs, create a new enrollment using the updated JSON file from Step 4.
Device Enrollment
After you've completed the one-time setup described above, you can start enrolling and provisioning devices. Use Meta's Device Setup App to enroll devices in ManageXR in bulk. Then, use the ManageXR Device Setup Tool to preload apps, files, and settings onto devices in bulk.
Step 1: Enroll devices in ManageXR using Meta Device Setup App
Grab fresh devices. Devices should be OFF and in a freshly factory reset state. If previously enrolled, make sure to remove it from both ManageXR and MHMS if already enrolled.
Open Meta’s Device Setup App. You can download the Meta Device Setup App from your Meta Admin Center (Go to Devices > Managed Devices > Enroll Devices)
Plug your devices into your computer. You can use a cable splitter to plug in multiple devices at once.
Set your provisioning wi-fi network in the Device Setup App settings
Enroll the device using the new enrollment created in One-time preparation Step 3. This will download new Meta firmware, enroll the device in MHMS, and enroll your device in ManageXR. It may take several minutes.
Step 2: Finish granting ManageXR permissions and preload content using ManageXR Device Setup Tool
Open the ManageXR Device Setup Tool on your computer.
Click the kebab menu (⋮) and select Push Configuration Update
This will grant ManageXR necessary permissions and load all of the content, wi-fi credentials, and settings from your configuration.
→ View help article
✅ Once you've completed both steps 1 and 2, the device will:
Be enrolled in both MHMS and ManageXR
Automatically receive and apply its assigned ManageXR configuration and content
Have the required permissions to use all ManageXR features
⚠️ Note: Even if you don't need to preload apps, files, and settings, it is important to complete device provisioning using the ManageXR Device Setup Tool. The Device Setup Tool grants permissions required for ManageXR to provide app analytics and download common applications. These permissions are granted by the user in-headset in the standard enrollment process (see step 5) .
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