Asistente de instalación en el navegador
Termine la instalación en el navegador con el asistente /install de cinco pasos.
Cuando el instalador del servidor termina, HWD POS se completa en el navegador. El asistente comprueba el entorno, se conecta a la base de datos, registra los datos de la empresa, crea la cuenta de administrador y activa la licencia.
Abrir el asistente
Desde cualquier equipo de la red local, abra la dirección que muestra el resumen final del instalador:
http://IP-DEL-SERVIDOR/installSi eligió un puerto distinto de 80, inclúyalo: http://IP-DEL-SERVIDOR:8080/install.
El asistente tiene cinco pasos: Bienvenida → Base de datos → Empresa → Administrador → Activación. No deja avanzar si falta algo obligatorio.
Las tablas de la base de datos no se crean hasta confirmar la clave de activación en el último paso. Hasta entonces puede volver atrás y corregir cualquier campo.
Paso 1: Bienvenida y comprobación del entorno
El asistente muestra la lista de requisitos con ✓ o ✗:
| Requisito | Obligatorio |
|---|---|
| PHP ≥ 8.2 | Sí |
| PDO MySQL | Sí |
| cURL | Sí |
| mbstring | Sí |
storage/ escribible | Sí |
| GD | Recomendado |
| Zip | Recomendado |
Si storage/ escribible aparece con ✗, es un problema de permisos (o de SELinux en AlmaLinux). Consulte Problemas frecuentes.
Paso 2: Base de datos
| Campo | Qué poner |
|---|---|
| Host | 127.0.0.1 si la base está en el mismo servidor; la IP del servidor de base de datos si está aparte. |
| Puerto | 3306 |
| Base | hwd_pos |
| Usuario | hwdpos_manager |
| Contraseña | La que generó el instalador (vea abajo). |
| Socket | Déjelo vacío. Solo para casos especiales de conexión local. |
El instalador guarda la contraseña generada en deploy/DB-CREDENTIALS.txt, legible solo por root. Para verla:
sudo cat /var/www/HWDPOS/deploy/DB-CREDENTIALS.txtEn un servidor de solo base de datos (instalación separada) el archivo es /root/HWDPOS-DB-CREDENTIALS.txt, porque en esa máquina no hay carpeta del sistema. También puede consultar las credenciales con hwdpanel (opción 8).
El asistente prueba la conexión antes de continuar. Si falla, el mensaje indica si el problema es de credenciales o de red.
Use 127.0.0.1, no localhost. Con localhost el controlador intenta usar un socket Unix y puede aparecer «No such file or directory».
Paso 3: Datos de la empresa
| Campo | Qué poner |
|---|---|
| Nombre de la empresa | Tal como debe salir en los documentos. Se puede cambiar después en Ajustes. |
| Símbolo de moneda | B/. en Panamá. |
| ITBMS (%) | El porcentaje entero: 7. |
| Número inicial de operación | Déjelo como está, salvo que continúe una numeración anterior. |
Paso 4: Usuario administrador
Este paso crea el super administrador, una cuenta que no se puede bloquear ni quedar sin permisos.
| Campo | Recomendación |
|---|---|
| Nombre completo | La persona responsable, no «Admin». |
| Usuario | Corto y sin espacios. |
| Contraseña | Mínimo 8 caracteres. Anótela: en este paso no hay recuperación por correo. |
Si se pierde, se restablece desde el servidor con hwdpanel (opción 7).
Paso 5: Activación
| Campo | Qué poner |
|---|---|
| Clave de activación | La que le entregó el proveedor. |
| Código de cliente | El que le entregó el proveedor. |
El servidor sale a internet para validar la licencia y la vincula a esta máquina. Al confirmar, el sistema crea la base de datos completa, aplica todas las actualizaciones de estructura y le lleva a la pantalla de inicio de sesión.
El servidor necesita internet en este paso. Si no puede llegar al servicio de activación, la activación no se completa. Compruébelo desde el servidor:
curl -sI https://3r.com.pa/pos | head -1Siguiente paso
Inicie sesión con la cuenta de administrador y continúe con Primeros pasos después de instalar.