# Installing Applications on an XR Device

**Choose** your installation method below:

**Meta Quest Devices**

<details>

<summary>Meta Horizon managed solutions (MDM)</summary>

Guide to adding prebuilt apps to your Meta Horizon managed solutions (MDM) admin console.

{% hint style="danger" %}
**WARNING** : **Before** launching an app on a **Meta Quest** device, ensure your Meta Quest device is operating on at least **v76**. \
\&#xNAN;*Due to a bug in Meta Quest OS **v74** apps may not launch properly.*
{% endhint %}

### Prerequisites <a href="#prerequisites" id="prerequisites"></a>

This guide is for **Meta Horizon managed solutions** admins and will walk you through the process of adding an app from MOTAR Hub to the admin dashboard.

Your account must have an admin role assigned with relevant permissions before you can create an app in Meta Admin Center. If you are unsure of your access permissions, contact your Meta admin or visit [Meta’s Manage admin roles and product access](https://work.meta.com/help/327223042205658) page to learn more.

### Get the App Listing URL <a href="#get-the-app-listing-url" id="get-the-app-listing-url"></a>

**Login** to Studio and go to the app listing > Distributions section

Toggle the dropdown arrow (indicated on the above image)

Locate the download URL and **click** the "copy" button.

You will need this URL in the upcoming steps!

### Add an App <a href="#add-app" id="add-app"></a>

1. Go to [**https://work.meta.com/admin/products**](https://work.meta.com/admin/products) and login with your admin account.
2. To add an app from an APK file to your organization’s apps in Admin Center, click **Apps** icon in the left menu of Admin Center.
3. In Manage apps, **click** "+ Add App" in the top right
4. **Pick** "Externally hosted"
5. Add details
   1. **App name: \[Name of your app here]**
   2. **Link to APK File: \[past URL link from Studio]**
6. Add visuals *(optional)*
   1. **Add Icon**
   2. **Add logo**

</details>

<details>

<summary>Meta Quest Developer</summary>

{% hint style="danger" %}
/**WARNING** : **Before** launching an app on a **Meta Quest** device, ensure your Meta Quest device is operating on at least **v76**. \
\&#xNAN;*Due to a bug in Meta Quest OS **v74** apps may not launch properly.*
{% endhint %}

## Getting Started

The Meta Quest 3 (and Meta Quest 2, Pro, 3s) use files called APKs to install apps. When interacting with an APK downloaded from MOTAR Hub, users can side-load the application to the Meta Quest device.<br>

Installing “ad hoc” applications to a Meta Quest device requires either a Meta Quest for Business MDM account, a developer account, 3rd party software, or a 3rd party MDM\*.

### Meta Horizon managed solutions (MDM)

1. [**https://work.meta.com/help/323729803480003/?helpref=hc\_fnav**<br>](https://work.meta.com/help/323729803480003/?helpref=hc_fnav)Adding apps to the Meta Horizon managed solutions accounts is covered in the above documentation.
2. **Login** to the Meta for Work Admin[ **https://work.meta.com/accounts\_center/**](https://work.meta.com/accounts_center/)
3. Add the **URL** to the **MDM Distribution List.**

{% hint style="warning" %}
3rd party MDM’s differ in functionality and are not covered in this guide. Please contact your MDM provider for details on how to install apps.
{% endhint %}

### First Time Setup (Developer Mode)

1. Create a developer account with Meta. You can do this by going to this[ **link**](https://accountscenter.meta.com/) and completing their signup process.
2. Verify your developer account by providing a credit card or mobile number.
3. If you have not used your headset, complete the initial headset setup/first time user experience before continuing.
4. Install the Meta Horizon app on your phone and log in with your newly created Meta account. (This step is an optional part of the first time user setup in the headset and may have been completed previously.)
   1. Download for Android[ **here**](https://play.google.com/store/apps/details?id=com.oculus.twilight\&hl=en_US)
   2. Download for iOS[ **here**](https://apps.apple.com/us/app/meta-horizon/id1366478176)
5. **Login** to the headset using the same developer account.
   1. You may have to logout if your current account in the headset is not the same as the developer account setup in **step 1**.
6. **Login** to the phone app with the same developer account.
7. Connect your headset to the app if not completed during **step 3**.
8. From your phone, enable Developer Mode under the Headset Settings.
9. **Open** toolbar
10. You can find this option by going to **Menu > Devices > Pick the device you wish to use > Headset Settings > Developer Mode**. Toggle Developer Mode to **ON**

<figure><img src="/files/i8QC6cHJ7zrEHcd3CgYZ" alt=""><figcaption></figcaption></figure>

## How to Install an App

There are three ways\* to side-load an app onto the Meta Quest headset, using the **Meta Quest Developer Hub** (via Wi-Fi or link cable), the **SideQuest application**, or the **Command Line** (via a link cable).

### **Meta Horizon managed solutions** (MDM)

1. [**https://work.meta.com/help/323729803480003/?helpref=hc\_fnav**<br>](https://work.meta.com/help/323729803480003/?helpref=hc_fnav)Adding apps to the Meta for Business accounts is covered in the above documentation.
2. **Login** to the Meta for Work Admin[ **https://work.meta.com/accounts\_center/**](https://work.meta.com/accounts_center/)
3. Add the URL to the **MDM Distribution List**

### Meta Quest Developer Hub (MQDH)

* Follow Meta’s device setup guide[ **here**](https://developers.meta.com/horizon/documentation/unity/unity-env-device-setup/)
* The following steps may repeat portions of the Meta guide
* Download the Meta Quest Developer Hub(ODH)[ **here**](https://developer.oculus.com/downloads/package/oculus-developer-hub-win).
  1. Next, install it by double clicking on it and running through the installation wizard.
* **Login** with your developer account
* **Connect** your Meta Quest headset to your computer via the[ **Link Cable or AirLink**](https://www.meta.com/help/quest/articles/headsets-and-accessories/oculus-link/connect-with-air-link/?srsltid=AfmBOop5IuBcpgHpW2NYOZQCFW1ZaMB1pn-0WIjeGY4bfoTKG5cas3wS)
* After setting your device to **Developer Mode**, you can open up the **Developer Hub** app to view your "connected" device under the **Device Manager** tab.

<figure><img src="/files/pjNNJly1DNLalogLjXYk" alt="" width="271"><figcaption><p>MQDH <strong>Device</strong> <strong>Manager</strong></p></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXewQ543WUwuYy8ZOr-1AQBgLAhvrygie8C7at3rn14ZyTZ7uuBXWNK9LWoH5U4UnR8aMkeGlEtkASptSmEXGvHfFbM7BZOkdN569vYXizFV4-o50L_HuSGXC8WaAVWzGvPEnOef?key=94UzjZoz3rxYBFT-uST1_cPz" alt=""><figcaption></figcaption></figure>

* You should see your device connected under the **Devices** tab. If you do not see your device and it is connected via a USB-C cable, click "**Set Up New Device**" and follow the on screen instructions.

<figure><img src="/files/lv7A5HBzGdfNaVzcrwoS" alt="" width="249"><figcaption><p>MQDH <strong>Devices</strong></p></figcaption></figure>

<figure><img src="/files/S4nywN5gDe9d9X45blBb" alt=""><figcaption><p>MQDH Device <strong>added</strong> but not connected.</p></figcaption></figure>

<figure><img src="/files/TltRy02UhtlaoXZr2LuG" alt=""><figcaption><p>MQDH Device <strong>connected</strong>.</p></figcaption></figure>

* **Click** the “Add Build” button to select and install your APK to the headset.

<figure><img src="/files/HsB6tbR4w2FuN6hFZFvq" alt=""><figcaption><p>MQDH <strong>add a build (APK)</strong></p></figcaption></figure>

* Your apk will now **install** on your Meta Quest 3.
* To launch the app, see [#launching-apps](#launching-apps "mention")

***

</details>

**HTC Vive Devices**

<details>

<summary>Vive Focus 3</summary>

## Manually Install an APK on a Vive Focus Device

{% hint style="warning" %}
Installing apps on your Focus 3 requires a USB-C cable. Plug the cable into your computer and then into the device. You may need to 'authorize' the computer in the headset.
{% endhint %}

**On Your Computer**

Once your computer is **connected** to your Focus 3, you should see the device folder in your computer file explorer.
\
Drag the **downloaded** MOTAR 3D to the Focus 3 "Downloads" folder. <br>

**On Your Focus 3**

Put on your Focus 3 and navigate to "Storage/Downloads" Click on the MOTAR 3D file and choose "Install"<br>

</details>

**Most Android based XR Devices**

<details>

<summary>SideQuest</summary>

**SideQuest** is a 3rd party tool which allows installing software outside of the Meta Quest Store (ad hoc). SideQuest is community run and the developers work closely with Meta to allow developers a platform for showcasing their early work. Recently, Meta has allowed some integration with SideQuest via the Meta Quest Labs.

* Download the SideQuest application[ **here**](https://sidequestvr.com/setup-howto). Next, install it by double clicking on it and running through the installation wizard.
* Once installed, connect your headset to the computer via[ **Link Cable or AirLink**](https://www.meta.com/help/quest/articles/headsets-and-accessories/oculus-link/connect-with-air-link/?srsltid=AfmBOop5IuBcpgHpW2NYOZQCFW1ZaMB1pn-0WIjeGY4bfoTKG5cas3wS)
  * You should see your device in the upper left corner

<figure><img src="/files/IM0MPbiTYdNkpzBZKg1m" alt="" width="217"><figcaption><p>SideQuest with a Quest connected.</p></figcaption></figure>

* **Click** the “Install APK” button and select your APK

<figure><img src="/files/PkLmSgzXoXNIFkIrET9T" alt="" width="374"><figcaption><p>SideQuest <strong>Install APK</strong></p></figcaption></figure>

* The install status can be seen in the “Running Tasks” tab.

<figure><img src="/files/pUSNHrdTYHkr9lTJan34" alt="" width="374"><figcaption><p>SideQuest check <strong>running tasks.</strong></p></figcaption></figure>

<figure><img src="/files/CIttIVjq02THUSofkOHR" alt="" width="375"><figcaption><p>SideQuest current running <strong>task list.</strong></p></figcaption></figure>

</details>

<details>

<summary>Command Line ADB Install (Windows only)</summary>

### Command Line (via Link Cable)

#### Windows/PC Only

1. Install ADB Drivers from[ **here**](https://developer.oculus.com/downloads/package/oculus-adb-drivers/). ADB is the software that lets PCs transfer and installs apps onto Android-based devices like Oculus standalone headsets. When the download finishes, unzip the downloaded file folder. Now **right-click** on **android\_winusb.inf** and click **Install**. When prompted click open followed by yes to get a message that says, **"The operation completed successfully."**
2. Next, you need to download the SDK platform tools from[ **here**](https://developer.android.com/studio/releases/platform-tools). Extract the contents of the platform-tools folder to an easy-to-find folder on your PC, such as **C:\ADB\users\\"YourName"** by selecting **all** the contents of the folder and copying(CTRL+C) and pasting(CTRL+V) it into the new location.
3. Make sure your headset is connected to your PC via a link cable(or compatible USB cable).
4. Open the **Command Prompt.** Right-click on the Windows **Start** button at the bottom left of your screen and click **Command Prompt (Administrator)** or click on the windows icon and type "cmd" and press enter.
5. In the command prompt type "**adb**" and a string of text should pop up if you completed everything correctly, but this message will pop up if the ADB drivers and platform tools weren't installed properly: **'adb' is not recognized as an internal or external command, operable program or batch file**.
6. Type **"ADB devices"** to view **"List of devices attached"** with the device listed below(represented by a list of numbers and letters). It will most likely say "unauthorized" next to that so you will need to put on your headset and select **"Always allow from this computer"** or **"allow"** to allow your Oculus to connect to your PC. After this, in the command prompt, it should say **"device"** instead of unauthorized.
7. Install the app via command line by manually entering in the file path and app name or **copying the path**. To copy the path, hold shift, right-click on the APK file, and select "copy as path".
8. In the command prompt, type **adb install -r command** followed by the **full path** to the sideloaded app you want to install then press enter. It should say **"success"** in the command prompt if everything worked correctly. Example:

```
adb install -r C:\Users\YourName\Downloads\MyCoolNewApp.apk
```

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.motar.com/motar-core-services/intro-to-core-services/devices/installing-applications-on-an-xr-device.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.