Instalação

Antes de iniciar a instalação, certifique-se de que seu domínio está configurado corretamente. Você precisa de um registro A apontando seu domínio (por exemplo, pos.yourdomain.com) para o endereço IP do seu servidor. Assim que a propagação do DNS estiver concluída, você pode prosseguir.

Configurar o Usuário do Servidor Web

Garanta que o usuário do servidor web (www-data no Ubuntu) tenha acesso adequado ao diretório do projeto. Isso evita problemas de permissão durante e após a instalação.

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

Se estiver instalando em um diretório personalizado, substitua /var/www pelo caminho escolhido.

Crie o projeto NexoPOS

Navegue até o diretório onde deseja instalar o NexoPOS e use o Composer para criar o projeto:

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

Configurar Nginx ou Apache

Seu servidor web deve apontar para o diretório /public do NexoPOS.

Exemplo do 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;
    }
}

Exemplo do Apache:

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

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

Depois de criar a configuração, ative-a e recarregue o seu 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

Crie o Banco de Dados

Acesse o MariaDB e crie um banco de dados e um usuário para o NexoPOS:

sudo mysql -u root -p

Então execute:

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

Concluir permissões dos arquivos

Garanta que os diretórios de armazenamento e de cache tenham permissão de escrita:

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

Execute o Assistente de Instalação

Abra o seu navegador e navegue até o seu domínio:

http://pos.yourdomain.com

Você será guiado pelo assistente de instalação, onde você:

• Forneça credenciais do banco de dados
• Configurar as configurações da aplicação
• Criar a conta de administrador

Assim que for concluída, sua instância do NexoPOS estará pronta para uso.