Environnement

Pour cette documentation, nous supposerons que vous êtes prêt à installer NexoPOS sur un environnement Linux. Étant donné que nous ciblons spécifiquement Ubuntu 24.04, cela s’applique également à 22.04 et 26.06 (d’autres versions restent compatibles à l’heure actuelle).

Pour une installation native sur Windows, reportez-vous à NexoPOS pour Windows. Toutefois, cela peut également s’appliquer à Windows Subsystem for Linux (WSL2).

Installation de PHP

Pour installer PHP sur votre environnement, vous devez exécuter la commande suivante :

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

Maintenant, nous allons procéder à l’installation des modules PHP requis.

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

Vous pouvez maintenant exécuter php -v pour voir la version de PHP installée.

Installation de Nginx / Apache

Installation de Nginx

Nous commencerons par Nginx, qui est la solution que nous utilisons pour la plupart de nos projets.

sudo apt update
sudo apt install -y nginx

Vous devrez peut-être, à terme, activer le service Nginx, et cela peut se faire de cette manière :

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

optionnellement, vous pouvez accorder l’accès au pare-feu à nginx. Cela est possible avec la commande suivante :

sudo ufw allow 'Nginx Full'

Configuration Apache

Si vous utilisez Apache au lieu de Nginx, la commande suivante s’applique à vous.

sudo apt update
sudo apt install -y apache2

De même, si vous souhaitez activer le service, vous devrez exécuter la commande suivante :

systemctl enable apache2 
sudo systemctl start apache2 
sudo systemctl status apache2

La même exception de pare-feu peut être appliquée à Apache en exécutant la commande suivante :

sudo ufw allow 'Apache Full'

Comme vous utilisez Apache pour NexoPOS, un module doit être activé pour Apache :

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

Installation de Composer

Composer est le gestionnaire de dépendances utilisé par Laravel et, par conséquent, requis pour exécuter NexoPOS. Il gère le téléchargement et la gestion de tous les packages PHP nécessaires à l’application. Sans Composer, NexoPOS ne peut ni s’installer ni fonctionner correctement.

Pour installer Composer globalement sur Ubuntu 24.04, exécutez :

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');"

Vous pouvez vérifier l’installation avec :

composer --version

Installation de MariaDB

MariaDB est le moteur de base de données utilisé par NexoPOS pour stocker toutes les données de l’application, y compris les ventes, les produits et les configurations. Il est entièrement compatible avec Laravel et offre une alternative fiable et performante à MySQL.

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

Nous pouvons maintenant activer le service à l’aide des commandes suivantes :

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

Après l’installation, il est recommandé de sécuriser le serveur de base de données :

sudo mysql_secure_installation

sudo mysql_secure_installation :

sudo mysql -u root -p

Installation de NVM et de Node

NVM (Node Version Manager) vous permet d’installer et de gérer facilement plusieurs versions de Node.js. C’est particulièrement utile pour NexoPOS lors de la création des ressources frontend avec des outils comme Vite.

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

Ensuite, chargez NVM dans votre session actuelle :

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

Installez Node.js 24 et définissez-le comme version par défaut :

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

Vous pouvez vérifier que tout fonctionne avec :

node -v && npm -v

Node.js 24 sera désormais utilisé par défaut dans les nouvelles sessions de terminal.

Apprenez dès maintenant comment procéder à l’installation.