Most Device Setup Tool errors trace back to network security settings. Firewalls, content filters, or endpoint protection software can interfere with ManageXR installation in ways that surface as different, sometimes unrelated-looking errors from one attempt to the next. In such cases, it's advised to try connecting to a hotspot or personal network and running the install again. If that resolves it, work with your network admin to allowlist the endpoints ManageXR needs access to. Here is a list of errors the Device Setup Tool can report, along with troubleshooting tips:
Install ManageXR error: cannot call write after a stream was destroyed
Install ManageXR error: cannot call write after a stream was destroyed
Why this happens: This error specifically shows up when your computer can reach the ManageXR API but can't reach our Google Storage URL, which is where the ManageXR Admin App is downloaded from during installation. That's usually caused by that specific endpoint being blocked by a network firewall or content filter, or by an intermittent network failure that interrupts that download without affecting other ManageXR traffic. This is more common on spotty hotspots or on any network that drops requests frequently.
Troubleshooting Steps:
Clear the Device Setup Tool cache.
Connect to a more stable network, and avoid heavily filtered school/district Wi-Fi during installation, if possible.
If this keeps happening on a school or enterprise network, it's usually a sign that the network is blocking or intermittently dropping requests specifically to ManageXR's Google Storage endpoint. In such cases, it's worth having your network admins confirm that the necessary endpoints are allowlisted. If you still see this error after trying the above steps, send your Device Setup Tool logs to support@managexr.com.
Factory Setup Incomplete
Factory Setup Incomplete
Why this happens: A Quest device has been plugged in right after being factory reset, before you finish the initial post-factory-reset setup process.
Troubleshooting Steps: You need to finish going through the initial setup steps in the headset and get to the native Meta home screen before plugging the device into the Device Setup Tool.
Preload/Provision Configuration Issue
Preload/Provision Configuration Issue
Why this happens: A higher version of an app is already installed. When you're preloading and the configuration has an older version of an app than what is currently on the device. The Device Setup Tool does not uninstall apps, so it can’t downgrade them when it is preloading a configuration.
OR
A version of an app in this configuration is not compatible with the version of Android on the device. Please remove it from this configuration.
Troubleshooting Steps: Uninstall the offending app using the adb command in the error message.
OR
Remove the offending app from the configuration, or make the configuration target a higher Software Development Kit (SDK) version
Inactive Subscription
Inactive Subscription
Why this happens: When you log in to an organization whose ManageXR subscription is expired or canceled.
Troubleshooting Steps: You can reactivate their ManageXR subscription or change organizations to one with an active subscription.
Subscription Full
Subscription Full
Why this happens: When you log into an organization that already has the max amount of devices registered.
Troubleshooting Steps: You can delete or move some devices from their organization or upgrade their ManageXR subscription to include more devices.
Wrong Organization
Wrong Organization
Why this happens: When you log into an organization, and a device that is already registered with ManageXR on another organization (whether the device has ManageXR installed on it or if it is just preregistered) is plugged in.
Troubleshooting Steps: Switch to the organization that the device is registered to.
Missing Configurations
Missing Configurations
Why this happens: When you log into an organization whose default configuration was deleted and no other configurations were created.
Troubleshooting Steps: Create a new configuration on the web console.
Enable Developer Mode
Enable Developer Mode
Why this happens: When a user has not yet turned on developer mode for a device and plugs it into ManageXR.
Troubleshooting Steps: The user needs to turn on developer mode.
Device Limit Exceeded
Device Limit Exceeded
Why this happens: When the device is targeting a configuration that has a shared app device limit that is full or exceeded.
Troubleshooting Steps: Target a different configuration, request more device licenses for the offending app, or remove the app from the configuration.
Powered Off
Powered Off
Why this happens: When a device is plugged into the Device Setup Tool but it is not turned on.
Troubleshooting Steps: Turn the device back on.
Requires Authorization
Requires Authorization
Why this happens: When a user has developer mode enabled, but they have not accepted the in-headset prompt to allow USB debugging. Note, this is not the same as the allow file transfer prompt.
Troubleshooting Steps: Accept the prompt in the headset.
Requires Manual Preparation
Requires Manual Preparation
Why this happens: When a user tried to install ManageXR on a Quest device and for some reason the UI automation that removes accounts could not remove all the accounts.
Troubleshooting Steps: Sometimes, you can try to install again and it will be able to remove the rest of the accounts. Otherwise, you must go in the headset and manually remove the Android accounts in the special settings menu.
Missing Permissions
Missing Permissions
Why this happens: When a device partially installs ManageXR, but not completely. Most of the time, this is because the device was unplugged before the installation finished. Either the device owner permission, the read logs permission, the get usage stats permissions, or the request install packages permissions (for android 11 and higher) is not there.
Troubleshooting Steps: Most of the time, the “Grant Permissions” button will be shown, and the user can just press that. If the button does not appear, they can just reinstall ManageXR.
Not Registered
Not Registered
Why this happens: When a device has ManageXR installed on it, but it was deleted from the web console.
Troubleshooting Steps: Reinstall ManageXR on the device.
Get Details Error
Get Details Error
Why this happens: When adb fails on the initial commands that are getting info about the device. This could be because the device is powering on or there is a faulty cable.
Troubleshooting Steps: Wait until the device is powered on, and refresh. Check the cables. Make sure Quest devices are on the home screen.
Set Device Auth Error Quest
Set Device Auth Error Quest
Why this happens: When the Device Setup Tool failed to set the device password or failed to launch the admin app service. Usually, this is due to a faulty cord or an adb timeout error.
Troubleshooting Steps: Reinstall ManageXR on the device, or press the “Fix Install” button.
Self-Signed Certificate In Certificate Chain
Self-Signed Certificate In Certificate Chain
Why this happens: A network firewall injects a certificate into the chain to sniff traffic. This is then throwing an error with our tool, which sees this as a Man-In-The-Middle attack.
Troubleshooting Steps: Allow ManageXR endpoints on your network. Connect to a hotspot or a personal network and try again. Try another computer.
Unable to Verify the First Certificate
Unable to Verify the First Certificate
Why this happens: A network security setting is blocking ManageXR from installing.
Troubleshooting Steps: Try a personal network, bypass endpoints, or try another computer.
Unable to Grant Admin App Permissions
Unable to Grant Admin App Permissions
Why this happens: Your device cannot install ManageXR because of a permissions issue. This error occurred because you either A) have another MDM installed or B) have an app installed that has stored account credentials on the device.
Troubleshooting Steps: Uninstall the offending app or run a factory reset to set up ManageXR on this device.
read ECONNRESET
read ECONNRESET
Why this happens: A network security setting is blocking ManageXR from installing.
Troubleshooting Steps: Try a personal network, bypass endpoints, or try another computer.
connect ETIMEDOUT
connect ETIMEDOUT
Why this happens: Internet connection speed is insufficient, or there is a cache error.
Troubleshooting Steps: Clear Device Setup Tool Cache
Connect to a faster network. We've also seen success if tried before or after hours of operation when network traffic is lighter
PackageParserException: Failed to parse
PackageParserException: Failed to parse
Why this happens: The APK file was corrupted during the download process.
Troubleshooting Steps:
Clear the cache of the Device Setup Tool (File, Clear Cache)
Reboot the Device Setup Tool
Retry installing ManageXR onto your device as normal
Failed to set device authentication credentials
Failed to set device authentication credentials
Why this happens: This device failed to authenticate and start communicating with ManageXR, so it could not complete its installation.
Troubleshooting Steps: Try the installation again. If the installation is still failing, contact support@managexr.com.
android.os.Binder.execTransactInternal (Binder.java:1030) at android.os.Binder.execTransact (Binder.java:1003)
android.os.Binder.execTransactInternal (Binder.java:1030) at android.os.Binder.execTransact (Binder.java:1003)
Why this happens: n/a
Troubleshooting Steps:
Retry the installation process
Clear Device Setup Tool Cache and try again.
Initialize Error: Error executing adbExec
Initialize Error: Error executing adbExec
Why this happens: Your device doesn't have a stable connection with your computer.
Troubleshooting Steps:
Restart your computer
Try using another cable
Use another port on the computer
Try using another computer for installation
this.resetProgress
this.resetProgress
Why this happens: You have an older version of the Device Setup Tool
Troubleshooting Steps: Try the install again. If it still fails, go into the headset and manually remove the Android accounts in the special settings menu.
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