Installazione

Prima di iniziare l’installazione, assicurati che il tuo dominio sia configurato correttamente. Devi avere un record A che punti il tuo dominio (ad es. pos.yourdomain.com) all’indirizzo IP del tuo server. Una volta completata la propagazione DNS, puoi procedere.

Configura l’utente del server Web

Assicurati che l’utente del server web (www-data su Ubuntu) abbia accesso adeguato alla directory del progetto. Questo evita problemi di permessi durante e dopo l’installazione.

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

Se stai installando in una directory personalizzata, sostituisci /var/www con il percorso scelto.

Crea il progetto NexoPOS

Naviga nella directory in cui desideri installare NexoPOS e usa Composer per creare il progetto:

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

Configura Nginx o Apache

Il tuo server web deve puntare alla directory /public di NexoPOS.

Esempio di 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;
    }
}

Esempio Apache:

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

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

Dopo aver creato la configurazione, abilitala e ricarica il server:

# 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 il database

Accedi a MariaDB e crea un database e un utente per NexoPOS:

sudo mysql -u root -p

Poi esegui:

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

Completa i permessi dei file

Assicurati che le directory di archiviazione e cache siano scrivibili:

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

Avvia la procedura guidata di installazione

Apri il browser e vai al tuo dominio:

http://pos.yourdomain.com

Verrai guidato/a attraverso la procedura guidata di installazione, in cui:

• Fornisci le credenziali del database
• Configura le impostazioni dell’applicazione
• Crea l’account amministratore

Una volta completato, la tua istanza NexoPOS sarà pronta all’uso.