Manual: Installing Aoostar X Screen Software on Proxmox VE.
Manual: Installing Aoostar X Screen Software on Proxmox VEThis guide combines the official manufacturer instructions with the required fixes for Proxmox VE. It automatically resolves the crashes caused by spaces in folder names and guarantees that all hardware sensors are fully functional.
Step 1: Preparation and Extraction
Open the terminal of your Proxmox server.Check if the required utility for extracting files is installed:bash apt update && apt install -y unzip
Extract the main ZIP file (use quotes due to the spaces in the name):bash unzip 'WTR MAX+GEM12+ PRO Screen Software.zip'
Enter the extracted folder and extract the specific Linux package:bash cd 'WTR MAX+GEM12+ PRO Screen Software'
unzip 'AOOSTAR-X-linux V1.3.6.zip'
Step 2: Relocate Files (Mandatory Path Fix)Note: The official path cannot contain special symbols, spaces, or Chinese characters, otherwise the background service will crash (Status 203/EXEC).Move the files to a safe, space-free system directory:bash sudo mkdir -p /opt/aoostar
sudo cp -r "/root/WTR MAX+GEM12+ PRO Screen Software/AOOSTAR-X-linux/." /opt/aoostar/
cd /opt/aoostar
Step 3: Install PVE Prerequisites & Screen ServiceProxmox VE requires these additional utility commands to register and start the software correctly:Update your system and ensure sudo is available:bash apt update
apt install -y sudo
Make the installation script executable and run it to create the system background service:bash chmod +x ./create_service.sh
sudo ./create_service.sh
Step 4: Install lm-sensors & it87 Driver.This step is required to display fan speeds, temperatures, and other hardware sensor information on your screen.Install lm-sensors:bash
sudo apt install -y lm-sensors.
Install the required kernel compilation dependencies for Proxmox:bash apt update && apt install -y pve-headers proxmox-headers-$(uname -r) dkms flex bison
Install the custom hardware driver:bashdpkg -i it87-dkms_1.0.63-1_all.deb
Verify that the background service is running smoothly:bash sudo systemctl status aoostar-x-service
(The status must display active (running) in green).
Step 5: Access and Translate the Web Interface.Open your internet browser on your main computer.Type the IP address of your Proxmox server followed by port 5123
Translating the page: The login interface loads in Chinese by default.Right-click on an empty space anywhere on the page.Select Translate to from the browser menu.The text will immediately switch to your own language.
Log in: Enter the following default credentials:Username: admin Password: 123456
Security: Once logged in, navigate to the gear icon (Settings) and change the default password immediately to keep your internal network secure.