NexoPOS en Plesk

Plesk es una de las aplicaciones de administración de alojamiento más populares disponibles. Una de las ventajas de usar Plesk es que cuentas con el soporte de Composer y GitHub, lo cual es útil para clonar e implementar un proyecto.

En esta guía, aprenderás cómo instalar NexoPOS en Plesk.

Requisitos

Antes de instalar NexoPOS, hablemos sobre los requisitos que deben cumplirse:

• SSH Access: this is required to run composer commands
• 2 GB of Ram: while it's not an absolute requirement, NexoPOS works well there.
• supervisor: If you cannot install supervisor from the CLI, you might need to request the installation to your provider.
• PHP 8.3 : it's the minimum version required.
• Composer 2: The popular PHP package manager.

Primeros pasos

Ahora desglosaremos todo lo que necesitas hacer para instalar NexoPOS en Plesk.

Configurando el dominio

El primer paso es configurar el dominio. Suponiendo que estás instalando NexoPOS en un subdominio, iremos a la sección de «Sitios web y dominios».

A partir de ahí, haz clic en «Agregar subdominio» (aunque también se aplica a «Agregar dominio»).

Esto te llevará a un formulario en el que tendrás que completar los detalles para tu subdominio. Así que, para el nombre del subdominio, elegiremos «pos», pero para el directorio del documento, necesitamos agregar «/public» ya que «index.php» está ubicado allí.

Ahora, habilitaremos Git (pero no es obligatorio si sabes cómo subir los archivos) para que podamos clonar el proyecto rápidamente.

Ahora se creará el dominio y podremos acceder a él. Ahora, necesitamos desactivar la página predeterminada de Plesk. Para eso, accederemos al administrador de páginas.

A partir de ahí, nos aseguraremos de abrir la carpeta «public» del proyecto y buscar el archivo «index.html» y eliminarlo.

Ahora, si accedes al sitio web, deberías ver un error como este.

Este error es causado por Composer, cuyas dependencias no están instaladas. Así que procederemos con la instalación.

Instalando dependencias

Ahora que el proyecto se ha copiado, necesitamos descargar e instalar los paquetes de Composer. Desde el sitio web y los dominios, haremos clic en «PHP Composer».

Luego, en la página siguiente, debes hacer clic en «Escanear». Si la carpeta es válida, deberías tener el paquete instalándose.

Cuando el escaneo haya finalizado, debería aparecer la siguiente página. Ahora solo tiene que hacer clic en «instalar» para continuar.

Creando un archivo de entorno

El archivo de entorno se utiliza para guardar las credenciales de la base de datos y realizar otras configuraciones útiles. Ahora necesitamos crear un archivo .env usando el .env.example existente (solo lo renombraremos). Luego, vayamos al administrador de archivos y localicemos el archivo .env.example.

Ahora debemos asegurarnos de cambiar el nombre del archivo “.env” únicamente.

Ahora, edita el archivo .env y asegúrate de cambiar el valor de "APP_KEY" por uno aleatorio y largo. Tu valor no debería ser exactamente igual al que aparece aquí.

Además, es posible que necesites conectarte a la CLI para ejecutar el comando en el directorio donde está instalado NexoPOS:

php artisan storage:link

A partir de ahora, si accedes al proyecto desde el navegador, deberías ver la página de bienvenida.

Solución de problemas

Mientras lo instala, es posible que se encuentre con algunos problemas, y trataremos de ayudarle a resolverlos.

Versión PHP predeterminada incorrecta

Si bien puedes asignar una versión de PHP a un proyecto, si tienes PHP 8.3 seleccionado como la versión PHP predeterminada para el sistema, entonces desde la CLI (en caso de que estés usando la CLI), la versión asignada al dominio o subdominio no es la misma. Alternativamente, puedes usar uno de los binarios disponibles en Plesk:

/opt/plesk/php/8.0/bin/php

Composer 2 instalado manualmente

En caso de que instales Composer 2 manualmente desde la CLI, probablemente necesites tener la ruta completa hacia él usando el comando:

which composer

Probablemente tendrás la siguiente salida.

Por lo general, podrías encontrarte usando Composer así en la CLI:

/opt/plesk/php/8.3/bin/php /usr/local/bin/composer install

Permiso de archivo incorrecto

Al iniciar sesión en el sistema, es posible que vea un error de problema de permisos.

Puedes resolverlo eliminando el archivo mencionado en el error.

Generando la APP_KEY desde la CLI

Si no puedes escribir una cadena aleatoria de letras y números, puedes usar la CLI para que la genere por ti.

php artisan key:generate

Resumiendo

Así que llegaste al final de esta guía. Si aún no puedes instalar NexoPOS, avísanos en [email protected].