apt-get update
DEBIAN_FRONTEND=noninteractive apt-get install -y \
  nginx mariadb-server \
  php8.2-fpm php8.2-mysql php8.2-gd php8.2-xml php8.2-zip \
  php8.2-mbstring php8.2-bcmath php8.2-curl php8.2-ldap php8.2-intl \
  unzip curl

php -v | head -1

PHP 8.2.35 (cli) (built: Oct 21 2026 06:29:51) (NTS)

mariadb --version

mariadb  Ver 15.1 Distrib 10.11.19-MariaDB, for debian-linux-gnu (x86_64) using  EditLine wrapper

nginx -v

nginx version: nginx/1.22.1

php -m | grep -iE 'gd|mbstring|pdo_mysql|curl|zip|bcmath|ldap|intl'

bcmath
curl
gd
intl
ldap
mbstring
pdo_mysql
zip

systemctl start nginx mariadb php8.2-fpm
systemctl is-active nginx mariadb php8.2-fpm

active
active
active

mariadb

CREATE DATABASE IF NOT EXISTS lhc CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER IF NOT EXISTS 'lhcuser'@'localhost' IDENTIFIED BY 'q1w2e3r4';
GRANT ALL PRIVILEGES ON lhc.* TO 'lhcuser'@'localhost';
FLUSH PRIVILEGES;
SHOW DATABASES;

+--------------------+
| Database           |
+--------------------+
| information_schema |
| lhc                |
| mysql              |
| performance_schema |
| sys                |
+--------------------+

cd /tmp
curl -L -o lhc-dist.tgz \
  'https://github.com/LiveHelperChat/livehelperchat/releases/download/4.97v/4.97v-with-dependencies.tgz'
ls -lh lhc-dist.tgz

-rw-r--r-- 1 root root 66M Oct 26 07:16 lhc-dist.tgz

mkdir -p /tmp/lhc-dist && tar -xzf lhc-dist.tgz -C /tmp/lhc-dist
ls /tmp/lhc-dist/

livehelperchat-master

mv /tmp/lhc-dist/livehelperchat-master /var/www/livehelperchat
ls /var/www/livehelperchat/lhc_web/

cache  cli  composer.json  composer.lock  cron.php  deploy.sh  design  doc
extension  ezcomponents  gulpfile.js  index.php  lib  modules  package-lock.json
package.json  pos  settings  translations  var  webpack.config.js

cd /var/www/livehelperchat/lhc_web
chown www-data:www-data -R cache/ var/ settings/
chmod -R 755 cache/
chmod 755 settings/
for d in storage userphoto storageform storageadmintheme botphoto bottrphoto \
         storageinvitation storagedocshare storagetheme tmpfiles; do
  chmod -R 755 var/$d
done
ls -ld cache var settings

drwxr-xr-x www-data cache
drwxr-xr-x www-data settings
drwxr-xr-x www-data var

cat > /etc/nginx/sites-available/lhc <<'EOF'
server {
    listen 80 default_server;
    server_name _;
    root /var/www/livehelperchat/lhc_web;
    index index.php;
    client_max_body_size 32M;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ [^/]\.php(/|$) {
        fastcgi_split_path_info ^(.+?\.php)(/.*)$;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }

    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2?)$ {
        expires 7d;
        access_log off;
    }
}
EOF

rm -f /etc/nginx/sites-enabled/default
ln -sf /etc/nginx/sites-available/lhc /etc/nginx/sites-enabled/lhc
nginx -t

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

systemctl reload nginx

http://<服务器地址>/index.php/site_admin/install/install

Checking folders permission
I can write to "cache/cacheconfig" directory     Yes
I can write to "cache/translations" directory    Yes
I can write to "cache/userinfo" directory        Yes
I can write to "cache/compiledtemplates" directory Yes
I can write to "settings/" directory             Yes
I can write to "var/storage" directory           Yes
I can write to "var/userphoto" directory         Yes
I can write to "var/storageform" directory       Yes
I can write to "var/storageadmintheme" directory Yes
I can write to "var/botphoto" directory          Yes
I can write to "var/bottrphoto" directory        Yes
I can write to "var/storageinvitation" directory Yes
I can write to "var/storagedocshare" directory   Yes
I can write to "var/storagetheme" directory      Yes
I can write to "var/tmpfiles" directory          Yes
Is the php_curl extension installed              Yes
Is the mbstring extension installed              Yes
Is the php-pdo extension installed               Yes
Is the gd extension installed                    Yes
Is the json extension detected                   Yes
Is the bcmath extension detected                 Yes
Is the php-xml extension detected                Yes
Minimum 5.4 PHP                                  Yes

Installation was completed
Installation is complete. You can start by adding users and departments.

http://<服务器地址>/index.php/site_admin/user/login

SELECT id,username,name,surname,email FROM lh_users ORDER BY id;

id  username   name      surname  email
1   admin      Admin     User     admin@example.com
2   operator1  Operator  One      operator1@example.com

http://<服务器地址>/index.php/chat/chatwidget

SELECT id,dep_id,nick,status FROM lh_chat;
SELECT id,chat_id,user_id,LEFT(msg,60) FROM lh_msg WHERE chat_id=1;

id  dep_id  nick     status
1   1       Visitor  0        -- 0 = 排队中 (pending)

id  chat_id  user_id  LEFT(msg,60)
1   1        0        Hello, I need help with my order.

id  chat_id  user_id  LEFT(msg,60)
1   1        0        Hello, I need help with my order.
2   1        1        Hello! This is support. How can I help you?
3   1        -1       Admin User has accepted the pending chat by sending a message

id  nick     status  user_id
1   Visitor  1       1        -- 1 = 进行中，user_id=1 即接管坐席

# 错误（返回 9 字节的 "Not Found"）
https://github.com/LiveHelperChat/livehelperchat/releases/download/v4.97v/4.97v-with-dependencies.tgz
# 正确
https://github.com/LiveHelperChat/livehelperchat/releases/download/4.97v/4.97v-with-dependencies.tgz

Your request was not processed as expected - but don't worry it was not your fault.
Please re-submit your request. If you experience the same issue you will need to
contact us via other means. Security token is missing. IP - 127.0.0.1

{"error":"true","r":"Try again or refresh a page. We could not verify your request."}