The standard build distribution system that Oculus uses for sending out bits scales to millions and provides a reliable way to get builds to users by leveraging the Facebook CDN that currently serves billions of users world wide. This system can also be used for sharing builds while in-development to your QA team, external partners, et cetera. With that said, there are times during development that you may want a bit more flexibility in how you distribute and run your build when the standard distribution system doesn’t fit, which is where side-loading is just the fix. The most common scenarios are:
In these scenarios, it is helpful to be able to run a side-loaded build that hasn't been uploaded to the Oculus CDN and is in a local folder on your machine or directly from a debugger. To be able to successfully run a side-loaded build on PC you will need to take the following three steps:
1. Get an entitlement to the application
There are a few different ways you can be granted an entitlement for the application.
2. Install the application through the Oculus Client
The Oculus client requires that the local file structure for application be set up before you can run side-loaded builds. If you don't yet have a real build ready to upload to the Oculus back end, you can just use a placeholder build with a dummy exe. Once your build is uploaded you should see the application available to install in the Oculus application either in your Library under not installed apps:
or in the Store under My Preview Apps:
3. Enable side-loading on your machine
There are two different ways to enable side-loading on your machine:
The easiest way to allow side-loading of builds is to use an account that has been marked as a developer for your organization. Any of your organization's authorized admins should be able to add users with the click of a button.
The biggest downside of this approach is that it grants that user access to the developer dashboard and the ability to edit metadata, upload builds, et cetera.
Windows Registry Key
If you wish to allow users to side-load builds but not get access to the developer dashboard, they can create the following Windows registry key* and restart their Oculus client:
AllowDevSideloaded(REG_DWORD) = 1 in HKLM\SOFTWARE\Wow6432Node\Oculus VR, LLC\Oculus
*DISCLAIMER: Edit the Registry at your own risk. Inappropriate changes to the Windows Registry can lead to “Bad stuff”! To safeguard against such an accident, we recommend that you back up your existing registry before making any changes.