> 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/set-up-your-environment.md).

# Set Up Your Environment

## LarkXR Installation and Launch

Before starting, ensure that your PC or server has a **dedicated GPU** (integrated GPUs are not supported) and that the target 3D application demo can run properly on the machine.

1. Download the **LarkXR Server App (Single Machine Version)** installer from the link provided in the registration email.

   <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FJGHTSyqA3Gh3f98Zqt1M%2F%E6%88%AA%E5%B1%8F2025-09-08%2009.57.47.png?alt=media&amp;token=52b0cbcb-8979-4cd4-a732-0ba313fe6c4a" alt=""><figcaption></figcaption></figure>
2. Install the application using the exe online installer.

   <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FV4beW2YbKHfVhuioZ0Bu%2F1280X1280%20(1).PNG?alt=media&amp;token=6605b252-f218-44b0-b78e-6377b29d61cd" alt=""><figcaption></figcaption></figure>
3. Once the installation is complete, a full user manual will automatically open in your browser. You may save this manual for later reference.

   <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2Fbcwy1yQmOzGoOdOgrmds%2F1280X1280%20(2).PNG?alt=media&amp;token=10db738b-90b3-4bce-a5eb-ee18b28ce07a" alt=""><figcaption></figcaption></figure>

   <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FQjerFdMSrspdibzojocM%2F1280X1280%20(3).PNG?alt=media&amp;token=94c93269-64a4-4276-8cad-bdaf9714ec06" alt=""><figcaption></figcaption></figure>

To launch the application:

* Open the **LarkXR Launcher**.
* Start each service component sequentially from top to bottom. The order is important when starting manually.

  <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FXcrVqdDZ19Et5Beb4HEk%2F1280X1280%20(4).PNG?alt=media&amp;token=222d5c3b-8c36-4d06-9b39-6455ca2e62c1" alt=""><figcaption></figcaption></figure>
* It is recommended to enable **Automatic Startup** so that the services launch automatically after a system reboot.

If you encounter issues during setup, you can either :

* Use the **AI Assistant** on <https://paraverse.cc/>

  <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2Fhd6zodNDF2BoHCpaejxK%2Ffe619cd1-24f5-4d80-a205-fcc099b142d8.png?alt=media&amp;token=c8b42377-27dd-45e7-8b98-8036a3f23afe" alt=""><figcaption></figcaption></figure>

* Refer to the full user manual at <https://docs.paraverse.cc/doc/280/>

* Contact us at <support@paraverse.cc> for further technical support.

## LarkXR License Code Activation

LarkXR requires a valid license for use. Your unique license code (CloudSN) is provided below. Please refer to this email for your specific validity period and applicable terms.![赞](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAB4AAAAeCAYAAAA7MK6iAAAAAXNSR0IArs4c6QAAAVlpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IlhNUCBDb3JlIDUuNC4wIj4KICAgPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4KICAgICAgPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIKICAgICAgICAgICAgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPgogICAgICAgICA8dGlmZjpPcmllbnRhdGlvbj4xPC90aWZmOk9yaWVudGF0aW9uPgogICAgICA8L3JkZjpEZXNjcmlwdGlvbj4KICAgPC9yZGY6UkRGPgo8L3g6eG1wbWV0YT4KTMInWQAAACdJREFUSA3t0DEBAAAAwqD1T+1vBohAYcCAAQMGDBgwYMCAAQMGfmAOLgABrSzR1AAAAABJRU5ErkJggg==)

To activate the license:

1. Open a web browser and go to  `http://localhost:8182` or `http://<local-ip>:8182`.
2. Log in with the default credentials:
   * Username: `admin`
   * Password: `123456`
   * Enter the CAPTCHA as shown.

> **Note:** For security reasons, it is strongly recommended to change the default password after the first login.

3. The license status (bottom-left corner) will show **Unauthorized**.
4. Copy the license code provided in the email.
5. In the **System Settings → Param Settings → License Type** tab:

   <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FRDucUtK1c5hbeFhL4VLx%2Fe4dd2367-e06c-439c-a657-174c7d9a37cb.png?alt=media&amp;token=690850cb-b007-49ff-89f5-ecb9949fdd2a" alt=""><figcaption></figcaption></figure>

* Select **CloudSN** from the dropdown menu.
* Paste the license code into the **Sn** field (ensure to **paste as plain text**).
* Click **Save**.

6. The license status will update to reflect the authorized type.
7. Navigate to **Data Center → Monitor** to confirm that one node is online.

   <figure><img src="https://2413582946-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faa1LT5SPRpqJMDpGwlW2%2Fuploads%2FtSTtzkQxrFG5kCpWQf6T%2Feab1ff40-543b-4fe2-9452-49be09454a77.png?alt=media&amp;token=0666666e-4e6d-47bb-8ca4-891f1d17a071" alt=""><figcaption></figcaption></figure>