Storage Configuration

## Overview

LarkXR supports the following storage types for system applications and cover image data:

- **Local Storage** (default)
- **Alibaba Cloud OSS**
- **AWS S3**

> **Note:** Huawei Cloud OBS and Minio storage options were removed in version V3.3.3.0.

## Important Notes

1. **Storage method cannot be changed** after an application has been uploaded — choose carefully before uploading.
2. When using object storage (Alibaba OSS or AWS S3) in standalone mode, set `pxy.host.as-admin-render-mixed-node=false` in `LarkXR_Standalone\larkxr-center\application.properties` to enable synchronization.
3. When switching from local storage to object storage in standalone mode, restart both the admin and agent services.

## Local Storage

Applications are stored on the central management node by default, in the `appli` folder under the deployment directory. You can customize the storage path via the LarkXR central service manager's configuration.

## Alibaba Cloud OSS Configuration

![](https://docs.paraverse.cc/media/202504/758b6c2d084849bcbc900e8698a48e717789.png)

Configure the following in `\larkxr-center\application.properties`:
- `protocol`, `bucket name`, `endpoint`, `Key`, `Secret`

Also update the `endpoint` in `\larkxr-render\application.properties`.

> When all nodes are deployed on the same Alibaba Cloud intranet, use the internal endpoint to reduce data transfer costs.

## AWS S3 Configuration

Configure the following in `larkxr-center/application.properties`:
- `protocol`, `bucket name`, `endpoint`, `access-url`, `Key`, `Secret`

AWS S3 also requires setting up a **CloudFront** distribution to provide an access domain for stored assets.

## VR Monitoring Data Storage

VR session metrics are stored in the `lark_metrics` database. Tracked fields include:

`client_render_latency`, `decode_latency`, `transport_latency`, `encode_latency`, `cmd_upload_latency`, `total_latency`, `client_fps`, `server_fps`, `rtt`, `sent_rate`, `frame_rate`, `resolution_ratio`

## Server Utilization Data Storage

Daily server utilization statistics are exported as CSV files in the `ServerUsageData` directory. Tracked fields include:

`cpuUsage`, `gpuUsage`, `gpuMemoryUsed`, `totalMem`, `freeMem`, `sendRate`, `recvRate`, `diskFree`