Deploying Apps

Learn how to deploy apps to multiple headsets in your fleet.

To deploy an app to your Oculus Quest headset, select all the apps you wish to deploy.

  1. From Device Fleet, select a group > select an individual headset. Note: Adding an app to a single headset here will apply to the whole group.

  2. Select the Apps tab > Add app. The Applications dropdown will show the apps currently available in Apps and Networks.

To troubleshoot app deployment, try these steps:

  1. Reboot the headset(s) to initiate a sync with Device Manager and the apps should begin to download.

  2. Check the headset periodically while the apps finish downloading. The time to download can depend on size and internet speed. If there are still no signs of the apps, reboot the headset again. This should begin the installation of the apps if they have finished downloading.

  3. Confirm the apps have now downloaded and installed to your headset(s).

Was this answer helpful?

To confirm apps have downloaded and installed to a headset, check the headset for app icons in Application Library. If there are no apps present, the app may still be downloading or installing in the background.

To make sure the app is downloading, you can try and sync the device with Device Manager:

  1. From your headset, select Settings then enter your Admin PIN.

  2. Select Check for updates and apply any changes that are listed. This checks the headset with Device Manager for any updates.

  3. Restart the headset and wait 5 minutes while apps and settings are updated.

  4. If the apps are still not appearing in your library, another update check may be needed.

Was this answer helpful?

Managing Apps

Learn how to manage apps once you've deployed them to the headsets in your fleet.

To add an app to your Device Manager:

  1. Upload the app to a cloud storage location of your choice.

  2. Copy the URL of the app you want to upload to Device Manager.

  3. Test the app URL link in a separate browser tab to make sure the link automatically starts downloading the app.

    • URL redirects aren't supported and the headset won't be able to download apps. Test your URLs in Chrome or Safari for automatic download.

  4. From Device Manager, click Apps and Networks.

  5. Click Add App. Add a name for you app and copy the URL for the app under the section App Binary.

    Once the form is filled out, click Add App. The app should now appear in Apps and Networks > All Apps.

    Keep in mind, the recommended file size for apps are:

    • APKs no larger than 1GB.

    • OBBs no larger than 4GB.

    Was this answer helpful?

    Apps can be hosted on any URI. Certain locations may require advanced settings such as HTTP headers for access.

    Keep in mind, the URI link must initiate a direct download. This is required by the headset to download and install applications.

    Was this answer helpful?

    Resource files, known as opaque binary blobs or OBBs, allow you to deploy additional content files with your apps. This might include a video file or asset that is used by your app.

    To add a resource file, or OBB, to your app:

    1. Copy the URI of the OBB file from your cloud storage account.

    2. From Device Manager, click Apps and Networks.

    3. Click to the right of the app you want to add an OBB to.

    4. Click Edit app info.

    5. Click the switch to turn Advanced Configurations on.

    6. Click Add Resource File and fill in the listed fields.

      • The filename must be the name of the OBB file. Filenames and URLs ending with .obb must be used. Spaces aren't accepted.

    7. Make sure Application OBB Path is set for the dropdown at the bottom of the form.

    8. Click Add resource file.

    9. Click Save App to finalize the app information.

    Note: Oculus for Business can support OBB files up to 4GB in size.

    Was this answer helpful?

    Hashes are used to increase security between your app and the headset. They make sure the same file being hosted on a server matches the one that's been deployed to a headset. If the hashes don't match, the app won't be deployed.

    To use a hash:

    1. Find the SHA-256 hash of the APK you're deploying using a hash application. Copy the hash from the app download or link.

    2. Go to Oculus for Business Device Manager > Click Apps and Networks to create or edit an app.

    3. Paste the copied hash in the Hash section.

    4. Click Save App to save the changes.

    Was this answer helpful?

    Through Device Manager, you can update the version of your apps to the headsets you've deployed. This would normally be done when the app has experienced a change.

    To update an app:

    1. From Device Manager, click Apps and Networks.

    2. Click then click Edit App Info.

    3. Update the app info with the new URI. Only the version number needs to be updated. Editing any other part of the URI may create errors or stop the app from working correctly.

    4. Update the app name in Device Manager to reflect the newest version.

    5. Click Save App.

    Once the steps above have been completed, go to your headset and check for updates in Settings. You may need to refresh multiple times before an update is recognized.

    Was this answer helpful?

    To edit app info and details:

    1. From Device Manager, click Apps and Networks.

    2. Find the app in your list, and click then click Edit App Info.

    3. When you're finished, click Save App.

    To remove an app from Device Manager:

    1. From Device Manager, click Apps and Networks.

    2. Under All Apps, you'll see a list of apps available in your app library.

    3. Click for the listed app you want to remove from your app library.

    4. Select Delete; you will be prompted to confirm the remove the app, select Confirm.

    To remove an app from a headset:

    1. When an app is removed from Apps and Networks, the app is not automatically removed from the headset. It will show unnamed as Sideloaded App.

    2. Once the headsets syncs with Device Manager, the app will be removed. If this sync doesn't happen automatically, restarting the headset may help.

    Keep in mind, if you remove an app that is set to be used in Kiosk Mode, you'll need to set up a new Kiosk Mode app for any headsets that were impacted.

    Was this answer helpful?