Installation

Avant de commencer l’installation, assurez-vous que votre domaine est correctement configuré. Vous devez créer un enregistrement A qui pointe votre domaine (par exemple, pos.votredomaine.com) vers l’adresse IP de votre serveur. Une fois la propagation DNS terminée, vous pouvez procéder.

Configurer l’utilisateur du serveur Web

Assurez-vous que l’utilisateur du serveur web (www-data sur Ubuntu) dispose des droits d’accès appropriés au répertoire du projet. Cela évite les problèmes de permissions pendant et après l’installation.

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

Si vous installez dans un répertoire personnalisé, remplacez /var/www par le chemin de votre choix.

Créer le projet NexoPOS

Accédez au répertoire dans lequel vous souhaitez installer NexoPOS et utilisez Composer pour créer le projet :

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

Configurer Nginx ou Apache

Votre serveur web doit pointer vers le répertoire /public de NexoPOS.

Exemple 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;
    }
}

Exemple Apache :

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

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

Après avoir créé la configuration, activez-la et redémarrez votre serveur :

# 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

Créer la base de données

Accédez à MariaDB et créez une base de données ainsi qu’un utilisateur pour NexoPOS :

sudo mysql -u root -p

Ensuite, exécutez :

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

Finaliser les autorisations des fichiers

Assurez-vous que les répertoires de stockage et de cache sont accessibles en écriture :

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

Lancer l’assistant d’installation

Ouvrez votre navigateur et accédez à votre domaine :

http://pos.yourdomain.com

Vous serez guidé tout au long de l’assistant d’installation, où vous :

• Fournir les informations d’identification de la base de données
• Configurer les paramètres de l’application
• Créer le compte administrateur

Une fois terminé, votre instance NexoPOS sera prête à être utilisée.