Instalación

Antes de comenzar la instalación, asegúrate de que tu dominio esté configurado correctamente. Necesitas un registro A que apunte tu dominio (por ejemplo, pos.tudominio.com) a la dirección IP de tu servidor. Una vez que la propagación de DNS esté completa, puedes continuar.

Configurar el usuario del servidor web

Asegúrate de que el usuario del servidor web (www-data en Ubuntu) tenga acceso adecuado al directorio del proyecto. Esto evita problemas de permisos durante y después de la instalación.

sudo chown -R www-data:www-data /var/www && sudo chmod -R 755 /var/www

Si estás instalando en un directorio personalizado, reemplaza /var/www por la ruta que elijas.

Crea el proyecto NexoPOS

Navega al directorio donde deseas instalar NexoPOS y usa Composer para crear el proyecto:

cd /var/www && composer create-project blair2004/nexopos nexopos --prefer-dist

Configurar Nginx o Apache

Tu servidor web debe apuntar al directorio /public de NexoPOS.

Ejemplo de Nginx:

server {
    listen 80;
    server_name pos.yourdomain.com;

    root /var/www/nexopos/public;
    index index.php index.html;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.4-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

Ejemplo de Apache:

<VirtualHost *:80>
    ServerName pos.yourdomain.com
    DocumentRoot /var/www/nexopos/public

    <Directory /var/www/nexopos/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Después de crear la configuración, actívala y reinicia tu servidor:

# Nginx
sudo ln -s /etc/nginx/sites-available/nexopos /etc/nginx/sites-enabled/ && sudo systemctl reload nginx

# Apache
sudo a2ensite nexopos.conf && sudo systemctl reload apache2

Crea la base de datos

Accede a MariaDB y crea una base de datos y un usuario para NexoPOS:

sudo mysql -u root -p

Entonces ejecuta:

CREATE DATABASE nexopos;
CREATE USER 'nexopos_user'@'localhost' IDENTIFIED BY 'strong_password';
GRANT ALL PRIVILEGES ON nexopos.* TO 'nexopos_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Finalizar permisos de archivos

Asegúrate de que los directorios de almacenamiento y caché tengan permisos de escritura:

sudo chown -R www-data:www-data /var/www/nexopos && \
sudo chmod -R 775 /var/www/nexopos/storage /var/www/nexopos/bootstrap/cache

Ejecutar el asistente de instalación

Abre tu navegador y navega a tu dominio:

http://pos.yourdomain.com

Te guiarán a través del asistente de instalación, donde harás:

• Proporcionar credenciales de la base de datos
• Configurar la configuración de la aplicación
• Crear la cuenta de administrador

Una vez completado, tu instancia de NexoPOS estará lista para usar.