浏览器安装向导
在浏览器中通过五个步骤的 /install 向导完成安装。
服务器安装程序完成后，HWD POS 的安装将在浏览器中完成。向导会检查运行环境、连接数据库、记录公司信息、创建管理员账户并激活许可证。
打开向导
在局域网内的任意一台计算机上，打开安装程序摘要末尾显示的地址：
http://SERVER-IP/install如果选择了 80 以外的端口，请包含端口：http://SERVER-IP:8080/install。
向导共有五个步骤：«Bienvenida → Base de datos → Empresa → Administrador → Activación»（欢迎 → 数据库 → 公司 → 管理员 → 激活）。缺少必填项时无法继续。
在最后一步确认激活密钥之前，数据库表不会被创建。在此之前，可以返回并更正任何字段。
第 1 步：欢迎与环境检查
向导以 ✓ 或 ✗ 列出各项要求：
| 要求 | 是否必需 |
|---|---|
| PHP ≥ 8.2 | 是 |
| PDO MySQL | 是 |
| cURL | 是 |
| mbstring | 是 |
storage/ 可写 | 是 |
| GD | 推荐 |
| Zip | 推荐 |
如果 storage/ 可写显示 ✗，说明是权限问题（在 AlmaLinux 上也可能是 SELinux）。参见常见问题。
第 2 步：数据库
| 字段 | 填写内容 |
|---|---|
| «Host»（主机） | 数据库在同一台服务器上时填 127.0.0.1；在单独的机器上时填数据库服务器的 IP。 |
| «Puerto»（端口） | 3306 |
| «Base»（数据库） | hwd_pos |
| «Usuario»（用户） | hwdpos_manager |
| «Contraseña»（密码） | 安装程序生成的密码（见下文）。 |
| «Socket»（套接字） | 留空。仅用于特殊的本地连接情况。 |
安装程序会将生成的密码保存在 deploy/DB-CREDENTIALS.txt 中，仅 root 可读。使用以下命令显示：
sudo cat /var/www/HWDPOS/deploy/DB-CREDENTIALS.txt在仅作数据库的服务器上（分离式安装），该文件为 /root/HWDPOS-DB-CREDENTIALS.txt，因为那台机器上没有应用目录。也可以通过 hwdpanel（选项 8）显示凭据。
向导在继续之前会测试连接。如果失败，提示信息会说明问题出在凭据还是网络。
请使用 127.0.0.1，而不是 localhost。使用 localhost 时，驱动会尝试 Unix 套接字，可能出现“No such file or directory”。
第 3 步：公司信息
| 字段 | 填写内容 |
|---|---|
| «Nombre de la empresa»（公司名称） | 按其在单据上应显示的样子填写。之后可在 «Ajustes»（设置）中修改。 |
| «Símbolo de moneda»（货币符号） | 巴拿马为 B/.。 |
| «ITBMS (%)» | 整数百分比：7。 |
| «Número inicial de operación»（起始交易编号） | 保持默认值，除非要延续之前的编号序列。 |
第 4 步：管理员用户
此步骤创建超级管理员，这是一个不会被锁定、也不会失去权限的账户。
| 字段 | 建议 |
|---|---|
| «Nombre completo»（全名） | 负责人的姓名，而不是“Admin”。 |
| «Usuario»（用户名） | 简短，不含空格。 |
| «Contraseña»（密码） | 至少 8 个字符。请记下来：此时还没有邮件找回功能。 |
如果密码丢失，可在服务器上通过 hwdpanel（选项 7）重置。
第 5 步：激活
| 字段 | 填写内容 |
|---|---|
| «Clave de activación»（激活密钥） | 由您的供应商提供。 |
| «Código de cliente»（客户代码） | 由您的供应商提供。 |
服务器会连接互联网验证许可证，并将其绑定到这台机器。确认后，系统会创建完整的数据库，应用所有结构更新，并带您进入登录界面。
此步骤中服务器需要访问互联网。如果无法连接激活服务，激活将无法完成。请在服务器上检查：
curl -sI https://3r.com.pa/pos | head -1下一步
使用管理员账户登录，然后继续阅读安装后的第一步。