# HandDriver Web Deployment and Usage Guide

## 1. Overview

### 1.1. Function Overview

1. HandDriver Web adopts B/S architecture, supporting access to the graphical interface through a browser on a PC. The browser can be closed once the DataGlove is properly connected. It is suitable for applications in the robotic field (the interface language currently only supports English).
2. During use, the receiver is connected to the PC where the server is located. The distance between the DataGlove and the receiver should not be too far, ideally kept within 2-3 meters, with a maximum range of approximately 5 meters.
3. **Only supports 1-To-2 receiver DataGlove.**
4. Compared to the HandDriver, the following features have been removed:
   * FBX/BVH recording and its related configuration options;
   * Thumb root joint adjustment;
   * Firmware upgrades (<mark style="color:red;">if the</mark> [<mark style="color:red;">firmware upgrade</mark>](https://udexreal.gitbook.io/udexreal-docs/software-instruction/channel-and-firmware#firmware-upgrade-1) <mark style="color:red;">is required, it is recommended to</mark> [<mark style="color:red;">download the Windows version</mark>](https://udexreal.gitbook.io/udexreal-docs/software-instruction/software-instruction/download-and-installation)<mark style="color:red;">. Note: always upgrade the DataGlove first, then upgrade the receiver.</mark>)

### 1.2. Environmental Requirements

* Google Chrome is recommended.
* Supported in Windows and Ubuntu currently.&#x20;

## 2. Software Download

### 2.1. Linux

**Ubuntu 22 and above：**

{% file src="<https://2082502898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8s1Ia6TfFovgyJ5JsDJZ%2Fuploads%2FbkciRlHv6uYiWn2v8h1M%2FHDW-Regular_V2.2.5_202604021755_Ubuntu22%2B_arm_64.zip?alt=media&token=fc56ddf8-9ff6-4ff3-8f66-81caafb4801c>" %}

{% file src="<https://2082502898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8s1Ia6TfFovgyJ5JsDJZ%2Fuploads%2Fpi6nldaFW1loZwIepznd%2FHDW-Regular_V2.2.5_202604021755_Ubuntu22%2B_x86_64.zip?alt=media&token=1ea72190-fed6-489c-94f4-c4b299727d91>" %}

**Ubuntu 20:**

{% file src="<https://2082502898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8s1Ia6TfFovgyJ5JsDJZ%2Fuploads%2FxTgfIGM6LPNcx5WWOKEU%2FHDW-Regular_V2.2.5_202604021753_Ubuntu20_x86_64.zip?alt=media&token=5d6d7de6-dfd4-41e6-b8d2-c696d53bcb18>" %}

### **2.2. Windows**

{% file src="<https://2082502898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8s1Ia6TfFovgyJ5JsDJZ%2Fuploads%2Fb4IEwnVE3wEDTwzR6SDD%2FHDW-Regular_V2.2.5_202604021755_win_x86_64.zip?alt=media&token=736f037d-d006-48f7-b4e2-24ff8b09f10a>" %}

## 3. Software Deployment and Operation

### 3.1. Linux

The Linux environment has supported automatic deployment since HD V2.2.4. The system will deploy both the frontend and backend simultaneously. For deployment methods, please refer to:

{% content-ref url="handdriver-web-deployment-and-usage-guide/automated-deployment-guide-for-handdriver-web-on-linux" %}
[automated-deployment-guide-for-handdriver-web-on-linux](https://udexreal.gitbook.io/udexreal-docs/software-instruction/handdriver-web-deployment-and-usage-guide/automated-deployment-guide-for-handdriver-web-on-linux)
{% endcontent-ref %}

{% hint style="warning" %}

* If using UFW or another firewall, open port 80 (or 443): `sudo ufw allow 'Nginx Full'`.
* If HTTPS is required, you can configure certificates as needed (e.g., using Let's Encrypt) and replace the `listen 8088` setting with the corresponding `listen 443 ssl` configuration.
* For manual deployment in a Linux environment and the Pasini licensed version, please refer to the historical documentation: [Manual Deployment Guide for HandDriver Web](https://udexreal.gitbook.io/udexreal-docs/software-instruction/handdriver-web-deployment-and-usage-guide/manual-deployment-guide-for-handdriver-web)
  {% endhint %}

### 3.2. Windows

#### 3.2.1. Server-side

For the Windows version of the server-side, after decompressing it, it can be placed in any directory. Simply double-click to run `HDService.exe`.

#### 3.2.2. Web Client

For Windows web client deployment, please refer to:

{% content-ref url="windows-iis-local-deployment-guide-for-handdriver-webclient" %}
[windows-iis-local-deployment-guide-for-handdriver-webclient](https://udexreal.gitbook.io/udexreal-docs/software-instruction/windows-iis-local-deployment-guide-for-handdriver-webclient)
{% endcontent-ref %}

## 4. Precautions

1. When multiple Web clients are connected to the same server, operations performed on one client (such as Calibration or Data Trans setting) will be synchronized to all other clients.
2. Data transmission: Data generated by each character is packaged independently and send seperately.
3. If the server crashes, the indicator light on the previously connected DataGlove will remain solid green. The server must be restarted before reconnecting the DataGlove.
4. The Old Plugin option in the Data Trans function is currently non-functional when selected.
5. After performing deployment and installation again, verify that the deployment path, IP, port number, and other information are correct. If the receiver cannot be recognized when opening the browser, clear the browser cache and try again.