# Deploy Applications

## Preparing the Application

* Package your Unreal Engine (UE), Unity, or other 3D engine project into a **Windows executable (.exe)** file.
* Run your the **Windows executable (.exe)** locally (without using LarkXR) to confirm it runs well on your machine.

## Uploading Application Packages

Navigate to  `http://localhost:8182` or `http://<local-ip>:8182`, go to **Applications → Package**, and click **Add Package**. There are two methods:

#### **Method 1: Local Program (the Windows executable (.exe) is stored on the same Machine)**

1. Select **Type Of Installed Program**, then click **Next**.

   <figure><img src="/files/56cOk9fq6X9cRp5BRTyO" alt=""><figcaption></figcaption></figure>
2. Enter the package name and version.
3. Locate the executable file (recommand to use the exe under the Binaries), right click >> choose \[Properties]

   <figure><img src="/files/0uQ4r0g4jgz3DZKenWhN" alt=""><figcaption></figcaption></figure>
4. \>> go to \[Security] tab, the Object name is your EXE File Path

   <figure><img src="/files/DoT15PpmnxIg6VWU5ugB" alt=""><figcaption></figcaption></figure>
5. For **UE programs**, select the `.exe` file located under the **Binaries** folder. For example, C:\MyDemoApp\MyDemoApp\Binaries\Win64\MyDemoApp.exe

   <figure><img src="/files/3b1DEZIEJFx09MVFkqlM" alt=""><figcaption></figcaption></figure>
6. Click **Save**. The new package will appear in the package list.

**!!! Particularly for Unreal Engine's exe, please conduct a few more steps following these Important Notes for Unreal Engine's exe**

**!!! Important Note for Unreal Engine's exe**

Particularly for Unreal Engine exe, you need to obtain launch parameters and input that properly in the LarkXR backend, otherwise it will cause certain issues for the stream.

* Start the `.exe` file locally (without using LarkXR).
* Open **Task Manager**, locate the process, right-click → *Go to Details*.

  <figure><img src="/files/badEkQgLnjJXzgVS4Hpi" alt=""><figcaption></figcaption></figure>
* Right-click the column header, select **Command Line**.

  <figure><img src="/files/hykppxA2NTwrIQqYdnJ2" alt=""><figcaption></figcaption></figure>
* Copy the text after `.exe`

  <figure><img src="/files/iKSygE3GbDELvthOH16N" alt=""><figcaption></figcaption></figure>
* Paste the parameters into the **Args** field in LarkXR.

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

#### **Method 2: Remote Program or Centralized Management**

1. Select **Type Of ZIP File**, then click **Next**.

   <figure><img src="/files/rMkzt5rqGGmA1I2MDuVE" alt=""><figcaption></figcaption></figure>
2. Upload the packaged application in `.zip` format (only `.zip` is supported).

   <figure><img src="/files/dxC8ll0jyA443UFmNqi7" alt=""><figcaption></figcaption></figure>
3. After uploading, click **Next**. Let it loads...
4. Input your package name and version.
5. Select the system-detected executable file path containing “.exe”.
   * For **UE programs**, select the `.exe` under **Binaries**.

     <figure><img src="/files/1ZPkMiea4Nz1B2UjA3tT" alt=""><figcaption></figcaption></figure>
6. Click **Save**. The new package will appear in the package list.

   > Both methods are supported. Choose the one that best fits your scenario.

**!!! Particularly for Unreal Engine's exe, please conduct a few more steps following these Important Notes for Unreal Engine's exe**

**!!! Important Note for Unreal Engine's exe**

Particularly for Unreal Engine exe, you need to obtain launch parameters and input that properly in the LarkXR backend, otherwise it will cause certain issues for the stream.

* Start the `.exe` file locally (without using LarkXR).
* Open **Task Manager**, locate the process, right-click → *Go to Details*.

  <figure><img src="/files/badEkQgLnjJXzgVS4Hpi" alt=""><figcaption></figcaption></figure>
* Right-click the column header, select **Command Line**.

  <figure><img src="/files/hykppxA2NTwrIQqYdnJ2" alt=""><figcaption></figcaption></figure>
* Copy the text after `.exe`

  <figure><img src="/files/iKSygE3GbDELvthOH16N" alt=""><figcaption></figcaption></figure>
* Paste the parameters into the **Args** field in LarkXR.

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

## Adding an Application

1. In the package list, click **Add** next to the corresponding package.

   <figure><img src="/files/xx1a1Lq5GgKfXpwuF3EX" alt=""><figcaption></figcaption></figure>
2. Enter the application name.
3. Select rendering type **SR (3D Shared Mode)**.
4. Configure **Max Concurrent Clients** according to the application size and available GPU resources.
   * This value determines how many concurrent users can run the application on the current machine.

     <figure><img src="/files/Q78uDoRtMt9Qe9zkkcoz" alt=""><figcaption></figcaption></figure>
5. Click **Save Configuration**.
6. Once saved, the new application will appear in the application list.
7. Access and Sharing

You can access different parts of the LarkXR system using:

* **Backend (Management Console):** `http://localhost:8182` or `http://<local-ip>:8182`
* **Frontend (Application List):** `http://localhost:8181` or `http://<local-ip>:8181`

  <figure><img src="/files/8XoI7ywDKx2dEEpX0XRe" alt=""><figcaption></figcaption></figure>

From the frontend, you can either:

* Click \[Enter] to access the stream
* Copy the streaming URL to your clipboard and share it
* Copy the QR code to your clipboard and share it

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

You can also go to the backend (8182), use the **Share** button next to an application to generate a link or QR code for sharing the LarkXR Streaming URL with your audience.

<figure><img src="/files/3BrajQIAVeicsFVaZzpu" alt=""><figcaption></figcaption></figure>

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

## Summary

LarkXR is a powerful platform for streaming 3D applications. This guide covered the **basic installation, license activation, and application deployment** to help you get started quickly.With this setup, you can successfully use LarkXR within a **local network environment**.If you want your applications to be accessible over the Internet, an externally accessible IP address is required. This will be explained in a separate guide - NAT Proxy Forwarding.


---

# 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://paraverse-technology.gitbook.io/larkxr/quickstart-guide/deploy-applications.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.
