> For the complete documentation index, see [llms.txt](https://paraverse-technology.gitbook.io/larkxr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paraverse-technology.gitbook.io/larkxr/quickstart-guide/deploy-applications.md).

# 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="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FcgMRDytNwjUDw5EV2t9h%2Ff42c2a05-730f-4107-b7ac-84141fd8a289.png?alt=media&amp;token=8948fa17-c454-4967-8590-a6014741cbc6" 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="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FGVFI7FFjLThyvzugon6T%2F02ee594a-460c-44b1-947f-e20693f98b66.png?alt=media&amp;token=82f2fefc-01dc-4a24-a893-a02595f3c2e1" alt=""><figcaption></figcaption></figure>
4. \>> go to \[Security] tab, the Object name is your EXE File Path

   <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FlEt8cvoxbf6lhbJg0A1h%2Ffa4e1eed-9914-4f49-9a74-6233e754052e.png?alt=media&amp;token=20a94179-34d5-4db3-923b-f4dbc02b414d" 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="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FUxsuY4aCehTS0kId0efJ%2F787b0708-5e94-4be8-b164-26e46fe7a63a.png?alt=media&amp;token=e14ff43d-d91f-4d0d-b5cf-efe89e645189" 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="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FpWG2BvoNGwXHJW3ZPq05%2F9f09a9c3-b550-4b0b-9a8d-c4cf8fd102e0.png?alt=media&amp;token=0d0ff51f-b0d2-43eb-980b-a7b9a9512140" alt=""><figcaption></figcaption></figure>
* Right-click the column header, select **Command Line**.

  <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2Fc3qsPdD0g5vupN6gY4rW%2F4f73dacb-d59e-441b-8eb9-9abb82849fdc.png?alt=media&amp;token=d2891b44-791f-483f-9ec3-15dd953c37e4" alt=""><figcaption></figcaption></figure>
* Copy the text after `.exe`

  <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FMIm9eBbBZonkZqgZ8CiV%2F864602f7-0cbd-4cf9-900f-eefcda40aa32.png?alt=media&amp;token=35f67d3e-a9f3-46fd-ac50-4c8ffe9781fa" alt=""><figcaption></figcaption></figure>
* Paste the parameters into the **Args** field in LarkXR.

  <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FC66veJypfM3TkNsiJHVz%2Fbb3c6f57-7865-47d1-b810-bf7b9ffee0ef.png?alt=media&amp;token=22e8976e-af62-4b00-b5a5-e2e615e753b5" alt=""><figcaption></figcaption></figure>

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

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

   <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FzfaptGe3exEJzjVTzsax%2F913e1dbe-3b89-4005-b786-1c7516c789a0.png?alt=media&amp;token=78b0b57f-8cd0-4ab1-8b8a-c02c2034dfe5" alt=""><figcaption></figcaption></figure>
2. Upload the packaged application in `.zip` format (only `.zip` is supported).

   <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FlEXyFhYKtXTJtkICfcHI%2F752de8a9-e725-48ae-b12f-7385bf630119.png?alt=media&amp;token=1b76798c-fdf6-4cb2-b70c-8f123f8209b3" 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="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FRap7ftTc5A1NxLjRtCDE%2Fd9e19ed8-b7a0-4211-aa30-4b33cddd947c.png?alt=media&amp;token=87525bef-768e-40d9-9415-dead7134869d" 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="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FpWG2BvoNGwXHJW3ZPq05%2F9f09a9c3-b550-4b0b-9a8d-c4cf8fd102e0.png?alt=media&amp;token=0d0ff51f-b0d2-43eb-980b-a7b9a9512140" alt=""><figcaption></figcaption></figure>
* Right-click the column header, select **Command Line**.

  <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2Fc3qsPdD0g5vupN6gY4rW%2F4f73dacb-d59e-441b-8eb9-9abb82849fdc.png?alt=media&amp;token=d2891b44-791f-483f-9ec3-15dd953c37e4" alt=""><figcaption></figcaption></figure>
* Copy the text after `.exe`

  <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FMIm9eBbBZonkZqgZ8CiV%2F864602f7-0cbd-4cf9-900f-eefcda40aa32.png?alt=media&amp;token=35f67d3e-a9f3-46fd-ac50-4c8ffe9781fa" alt=""><figcaption></figcaption></figure>
* Paste the parameters into the **Args** field in LarkXR.

  <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FC66veJypfM3TkNsiJHVz%2Fbb3c6f57-7865-47d1-b810-bf7b9ffee0ef.png?alt=media&amp;token=22e8976e-af62-4b00-b5a5-e2e615e753b5" alt=""><figcaption></figcaption></figure>

## Adding an Application

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

   <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FIyjQWwJkFF6WdqmQsNcP%2Fd5de642a-409e-4605-a55f-0fd2c1a15509.png?alt=media&amp;token=c0f2b2ab-9383-4b3d-9f05-eb95b4b849bb" 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="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2Fga4ZVfmmLBUDNNTnlV8e%2Fbd3bc2d8-53f3-4bc0-951b-879a46132956.png?alt=media&amp;token=4d92becc-a923-4764-b767-21d15e990fd3" 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="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FEmj3uH6M70nt4fUf0yTL%2Fd63b8151-4c45-4cb7-b464-2b91c5048712.png?alt=media&amp;token=95cd8897-4657-4cb6-b03b-a2a83bdf7285" 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="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FXmTNgeHkfYLhGwZk1Iyc%2F1d2d5ba9-c20a-4796-99ed-bbd55424202f.png?alt=media&amp;token=bb5739e6-f66d-441b-aa94-9e276cb5c941" 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="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FljgzKG54R1NAkM6ZfXnu%2F3c074eb2-01e0-4184-a3d4-abd46e8a863c.png?alt=media&amp;token=21a563e2-5e16-42f3-a2e8-9e51822568b8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FyZHbZcdXLs95l6a2b2t2%2F958ec3c7-12c8-4f27-a015-49441da092ed.png?alt=media&amp;token=c53700ab-1194-4c69-b3b6-4fe5b92dfd77" 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.
