# 摘自官方 Wiki「Interactive installation bash-script」节
sudo apt install wget
wget https://raw.githubusercontent.com/freescout-help-desk/freescout/dist/tools/install.sh
chmod u+x install.sh
sudo ./install.sh

# 更新索引并安装软件源管理工具
sudo apt update
sudo apt install -y software-properties-common

# 添加 ondrej/php PPA（实测回显）
sudo add-apt-repository -y ppa:ondrej/php

Adding deb entry to /etc/apt/sources.list.d/ondrej-ubuntu-php-jammy.list
Adding disabled deb-src entry to /etc/apt/sources.list.d/ondrej-ubuntu-php-jammy.list
Adding key to /etc/apt/trusted.gpg.d/ondrej-ubuntu-php.gpg with fingerprint B8DC7E53946656EFBCE4C1DD71DAEAAB4AD4CAB6

# 刷新索引并确认 php8.3 候选版本
sudo apt update
apt-cache policy php8.3-fpm

php8.3-fpm:
  Installed: (none)
  Candidate: 8.3.35-1+ubuntu22.04.1+deb.sury.org+1

# 一次性安装 Nginx + MariaDB + Git + PHP 8.3 及 FreeScout 必需扩展
sudo apt install -y nginx mariadb-server git curl \
  php8.3-fpm php8.3-mysql php8.3-mbstring php8.3-xml php8.3-imap \
  php8.3-zip php8.3-gd php8.3-curl php8.3-intl php8.3-cli

php -v | head -1
nginx -v
mysql --version

PHP 8.3.35 (cli) (built: Sep 25 2026 05:16:32) (NTS)
nginx version: nginx/1.18.0 (Ubuntu)
mysql  Ver 15.1 Distrib 10.6.23-MariaDB, for debian-linux-gnu (x86_64) using  EditLine wrapper

# 核对 FreeScout 必需扩展已就位（应有 imap/mbstring/gd/intl/curl/zip/xml/mysql 等）
php -m | grep -iE 'imap|mbstring|gd|intl|curl|zip|xml|mysql'

curl
gd
imap
intl
libxml
mbstring
mysqli
mysqlnd
pdo_mysql
SimpleXML
xml
xmlreader
xmlwriter
zip

sudo systemctl enable --now nginx
sudo systemctl enable --now php8.3-fpm
sudo systemctl enable --now mariadb

systemctl is-active nginx
systemctl is-active php8.3-fpm
systemctl is-active mariadb

active
active
active

echo 'cgi.fix_pathinfo=0' | sudo tee -a /etc/php/8.3/fpm/php.ini
sudo systemctl restart php8.3-fpm

grep 'cgi.fix_pathinfo' /etc/php/8.3/fpm/php.ini

cgi.fix_pathinfo=0

sudo mysql

CREATE DATABASE `freescout` CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'freescout'@'localhost' IDENTIFIED BY 'q1w2e3r4';
GRANT ALL PRIVILEGES ON `freescout`.* TO 'freescout'@'localhost';
FLUSH PRIVILEGES;

SHOW DATABASES;

+--------------------+
| Database           |
+--------------------+
| freescout          |
| mysql              |
| performance_schema |
| sys                |
+--------------------+

EXIT;

# 清空默认站点目录并交给 Web 进程用户 www-data
sudo rm -f /var/www/html/index.nginx-debian.html
sudo chown www-data:www-data /var/www/html
cd /var/www/html

# 检出 1.8.248 标签（浅克隆加速）
sudo -u www-data git clone --depth 1 -b 1.8.248 https://github.com/freescout-help-desk/freescout .

Note: switching to '1.8.248'.

You are in 'detached HEAD' state. ...
Turn off this advice by setting config variable advice.detachedHead to false

ls /var/www/html | head -12
grep -m1 "'version'" /var/www/html/config/app.php

DOCUMENTATION.md LICENSE Modules README.md app artisan bootstrap composer.json composer.lock config database overrides package.json phpcs.xml phpunit.xml public resources routes server.php storage tools vendor webpack.mix.js
    'version' => '1.8.248',

test -d /var/www/html/vendor && echo "vendor exists"
sudo chown -R www-data:www-data /var/www/html

vendor exists

cd /var/www/html
sudo -u www-data cp .env.example .env

APP_URL=http://192.168.146.128:8155
DB_DATABASE=freescout
DB_USERNAME=freescout
DB_PASSWORD=q1w2e3r4

sudo -u www-data php artisan key:generate
sudo -u www-data php artisan freescout:clear-cache

Application key [base64:dE2AnW6wfIo7vB/r8N0HpaS6ykoL7b6GBh9G0igCnWU=] set successfully.
Configuration cached successfully!
Cleared: JS and CSS builds
Created: /js/builds/vars.js

sudo -u www-data php artisan storage:link

The [public/storage] directory has been linked.

cd /var/www/html
sudo -u www-data php artisan migrate --force

Migrating: 2026_08_15_010101_update_indexes_in_conversations_table
Migrated:  2026_08_15_010101_update_indexes_in_conversations_table
Migrating: 2026_08_28_010101_add_conversation_id_column_to_notifications_table
Migrated:  2026_08_28_010101_add_conversation_id_column_to_notifications_table
Migrating: 2026_10_16_010101_update_attachment_tokens_in_bodies
Migrated:  2026_10_16_010101_update_attachment_tokens_in_bodies

sudo mysql -e "USE freescout; SHOW TABLES;" | head -8
sudo mysql -e "USE freescout; SHOW TABLES;" | wc -l

Tables_in_freescout
activity_logs
attachments
conversation_folder
conversations
customer_channel
customers
emails

sudo -u www-data php artisan freescout:create-user \
  --role=admin --firstName=Admin --lastName=User \
  --email=admin@freescout.local --password=q1w2e3r4

User created with id: 1

sudo -u www-data touch /var/www/html/storage/.installed
ls -la /var/www/html/storage/.installed

-rw-r--r-- 1 www-data www-data 0 Oct 21 04:27 /var/www/html/storage/.installed

sudo tee /etc/nginx/sites-available/freescout > /dev/null <<'NGINX'
server {
    listen 80;
    listen [::]:80;

    server_name _;

    root /var/www/html/public;

    index index.php index.html index.htm;

    error_log /var/www/html/storage/logs/web-server.log;

    # Max. attachment size.
    client_max_body_size 20M;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    location ~* ^/storage/attachment/ {
        expires 1M;
        access_log off;
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~* ^/(?:css|js)/.*\.(?:css|js)$ {
        expires 2d;
        access_log off;
        add_header Cache-Control "public, must-revalidate";
        add_header X-Content-Type-Options "nosniff";
    }
    location ~ /\. {
        deny  all;
    }
}
NGINX

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

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

sudo systemctl reload nginx

sudo systemctl restart php8.3-fpm
systemctl is-active nginx
systemctl is-active php8.3-fpm

active
active

systemctl is-active cron || sudo apt install -y cron
sudo systemctl start cron
systemctl is-active cron

active

sudo crontab -u www-data -e

* * * * * php /var/www/html/artisan schedule:run >> /dev/null 2>&1

crontab -u www-data -l

* * * * * php /var/www/html/artisan schedule:run >> /dev/null 2>&1

sudo -u www-data php /var/www/html/artisan freescout:check-requirements

PHP Version
 8.3.35........................ OK
PHP Extensions
 OpenSSL....................... OK
 PDO........................... OK
 Mbstring...................... OK
 Tokenizer..................... OK
 JSON........................... OK
 XML............................ OK
 GD............................. OK
 fileinfo...................... OK
 ZIP............................ OK
 iconv......................... OK
 cURL.......................... OK
 DOM............................ OK
 libxml........................ OK
 intl.......................... OK
 pcntl (console PHP)........... OK
Functions
 shell_exec (PHP).............. OK
 proc_open (PHP)............... OK
 fpassthru (PHP)............... OK
 symlink (PHP)................. OK
 iconv (PHP)................... OK
 dns_get_record (PHP).......... OK
 inet_pton (PHP)............... OK
 pcntl_signal (console PHP).... OK
 ps (shell).................... OK

curl -s -o /dev/null -w 'HTTP %{http_code}\n' http://192.168.146.128:8155/login
curl -s -o /dev/null -w 'HTTP %{http_code} -> %{redirect_url}\n' http://192.168.146.128:8155/

HTTP 200
HTTP 302 -> http://192.168.146.128:8155/login

cd /tmp
TOKEN=$(curl -s -c cj.txt http://192.168.146.128:8155/login | grep -oP 'name="_token" value="\K[^"]+' | head -1)
curl -s -b cj.txt -c cj.txt -o /dev/null -w 'login: HTTP %{http_code} -> %{redirect_url}\n' \
  -d "_token=$TOKEN" -d 'email=admin@freescout.local' -d 'password=q1w2e3r4' \
  http://192.168.146.128:8155/login
curl -s -b cj.txt http://192.168.146.128:8155/ | grep -oE '<title>[^<]*</title>'

login: HTTP 302 -> http://192.168.146.128:8155/home
<title>Dashboard - FreeScout </title>

sudo -u www-data php /var/www/html/artisan --version

Laravel Framework 5.5.40

sudo -u www-data /var/www/html/tools/update.sh --yes

#!/usr/bin/env bash
#
# FreeScout upgrade script.
# ...
echo -e "\e[33mMake sure to create a backup of the application before you continue.\e[0m";

cd /var/www/html
sudo -u www-data git fetch --depth 1 origin tag 1.8.240
sudo -u www-data git checkout 1.8.240
sudo -u www-data php artisan freescout:clear-cache

sudo systemctl restart nginx        # 重启 Web 服务器
sudo systemctl restart php8.3-fpm   # 重启 PHP 进程池
sudo systemctl restart mariadb      # 重启数据库
sudo systemctl restart cron         # 重启定时任务服务

sudo -u www-data php /var/www/html/artisan freescout:clear-cache

systemctl is-active nginx php8.3-fpm mariadb cron | tr '\n' ' '; echo

active active active active

sudo -u www-data php /var/www/html/artisan freescout:check-requirements | grep -c OK

25

E: Failed to fetch http://archive.ubuntu.com/ubuntu/dists/jammy-backports/InRelease  502  Bad Gateway [IP: 192.168.1.62 7897]
E: The repository 'http://archive.ubuntu.com/ubuntu jammy-backports InRelease' is no longer signed.

unset http_proxy https_proxy
sudo add-apt-repository -y ppa:ondrej/php

Untrusted Host: localhost. Add the following to your .env file and clear cache: APP_TRUSTED_HOSTS ='localhost'

APP_TRUSTED_HOSTS="192.168.146.128,helpdesk.example.com"

sudo -u www-data php /var/www/html/artisan freescout:clear-cache

# 1) 停止服务并禁用（每行一个单元）
sudo systemctl stop nginx
sudo systemctl stop php8.3-fpm
sudo systemctl stop mariadb
sudo systemctl stop cron

# 2) 移除 Nginx 站点配置
sudo rm -f /etc/nginx/sites-enabled/freescout /etc/nginx/sites-available/freescout

# 3) 卸载软件包（保留 --purge 连配置一起删）
sudo apt purge -y nginx nginx-common php8.3-fpm php8.3-* mariadb-server mariadb-client
sudo apt autoremove -y

# 4) 删除数据库数据目录与应用目录
sudo rm -rf /var/lib/mysql /var/www/html

# 5) 清理 www-data 的 crontab
sudo crontab -u www-data -r