Ambiente

Per questa documentazione, assumeremo che tu sia disposto a installare NexoPOS su un ambiente Linux. Poiché ci rivolgiamo specificamente a Ubuntu 24.04, questo vale anche per 22.04 e 26.06 (restano compatibili anche altre versioni, per il momento).

Per l’installazione nativa su Windows, fare riferimento a NexoPOS per Windows. Tuttavia, questo può valere anche per Windows Subsystem for Linux (WSL2).

Installazione di PHP

Per installare PHP nel tuo ambiente, dovrai eseguire il seguente comando:

sudo apt update 
sudo apt install -y software-properties-common ca-certificates lsb-release apt-transport-https 
sudo add-apt-repository -y ppa:ondrej/php 
sudo apt update

Ora procederemo con l’installazione dei moduli PHP richiesti.

sudo apt install -y php8.4 php8.4-cli php8.4-fpm php8.4-common php8.4-mysql php8.4-zip php8.4-gd php8.4-mbstring php8.4-curl php8.4-xml php8.4-bcmath php8.4-intl php8.4-soap php8.4-readline php8.4-opcache php8.4-redis php8.4-imagick php8.4-sqlite3 unzip curl git

Ora puoi eseguire php -v per vedere la versione di PHP installata.

Installazione di Nginx / Apache

Installazione di Nginx

Inizieremo con Nginx, che è la soluzione che utilizziamo per la maggior parte dei nostri progetti.

sudo apt update
sudo apt install -y nginx

Potresti eventualmente dover abilitare il servizio Nginx e puoi farlo in questo modo:

sudo systemctl enable nginx 
sudo systemctl start nginx 
sudo systemctl status nginx

opzionalmente potresti voler concedere l’accesso al firewall a nginx. Questo è possibile con il seguente comando:

sudo ufw allow 'Nginx Full'

Configurazione Apache

Se stai usando Apache invece di Nginx, il seguente comando è applicabile a te.

sudo apt update
sudo apt install -y apache2

Allo stesso modo, se desideri abilitare il servizio, dovrai eseguire il seguente comando:

systemctl enable apache2 
sudo systemctl start apache2 
sudo systemctl status apache2

La stessa eccezione del firewall può essere applicata ad Apache eseguendo il seguente comando:

sudo ufw allow 'Apache Full'

Poiché stai utilizzando Apache per NexoPOS, deve essere abilitato qualche modulo per Apache:

sudo a2enmod rewrite headers env dir mime && sudo systemctl restart apache2

Installazione di Composer

Composer è il gestore delle dipendenze utilizzato da Laravel e quindi necessario per eseguire NexoPOS. Gestisce il download e la gestione di tutte le librerie PHP richieste dall’applicazione. Senza Composer, NexoPOS non può installarsi o funzionare correttamente.

Per installare Composer globalmente su Ubuntu 24.04, esegui:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && \
php composer-setup.php --install-dir=/usr/local/bin --filename=composer && \
php -r "unlink('composer-setup.php');"

Puoi verificare l’installazione con:

composer --version

Installazione di MariaDB

MariaDB è il motore di database utilizzato da NexoPOS per archiviare tutti i dati dell’applicazione, inclusi vendite, prodotti e configurazioni. È pienamente compatibile con Laravel e offre un’alternativa affidabile ad alte prestazioni a MySQL.

sudo apt update 
sudo apt install -y mariadb-server mariadb-client 

Ora possiamo abilitare il servizio utilizzando i seguenti comandi:

sudo systemctl enable mariadb 
sudo systemctl start mariadb 
sudo systemctl status mariadb

Dopo l’installazione, si consiglia di mettere in sicurezza il server del database:

sudo mysql_secure_installation

sudo mysql_secure_installation:

sudo mysql -u root -p

Installazione di NVM e Node

NVM (Node Version Manager) ti consente di installare e gestire facilmente più versioni di Node.js. È utile per NexoPOS quando si sviluppano asset frontend con strumenti come Vite.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Quindi carica NVM nella tua sessione corrente:

export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

Installa Node.js 24 e imposta la versione predefinita:

nvm install 24 && nvm use 24 && nvm alias default 24

Puoi verificare che tutto funzioni con:

node -v && npm -v

Node.js 24 verrà ora utilizzato come impostazione predefinita nelle nuove sessioni di terminale.

Scopri ora come procedere con l’installazione.