Comment installer ERPNext sur Debian 12

ERPNext est une solution de planification des ressources d’entreprise (ERP) open-source. ERPNext peut être utilisé dans diverses industries telles que la fabrication, la distribution, le commerce de détail, le commerce, les services, l’éducation, les organisations à but non lucratif et la santé. Il propose également des modules tels que la comptabilité, la CRM, les ventes, les achats, le site web, le commerce électronique, le point de vente, la fabrication, l’entrepôt, la gestion de projet, l’inventaire et les services.

ERPNext est une plateforme ERP d’entreprise sous licence GNU General Public Licence v3. Il est principalement écrit en Python et JavaScript et a été développé par Frappe Technologies Pvt. Ltd. ERPNext est une application écrite sous le framework frappe, un framework web open source en Python et JavaScript.

ERPNext a été développé comme une alternative à des services tels que NetSuite d’Oracle, QAD, Tython, OpenBrave et Odoo. En termes de fonctionnalités, ERPNext est similaire à Odoo (anciennement OpenERP).

Dans ce tutoriel, nous vous guiderons à travers l’installation d’ERPNext sur le serveur Debian 12. Vous installerez ERPNext avec un serveur de base de données MariaDB, Nginx comme proxy inverse et un gestionnaire de processus Supervisor.

Prérequis

Pour commencer, assurez-vous d’avoir accès à :

• Un serveur Debian 12.
• Un utilisateur non-root avec des privilèges d’administrateur sudo.
• Un nom de domaine pointé vers l’adresse IP du serveur.

Installation des dépendances

ERPNext est un logiciel ERP et CRM open-source écrit en Python. Pour installer ERPNext, vous devez installer des dépendances telles que Python 3, le serveur MariaDB, Node.js, le gestionnaire de paquets Yarn, Nginx, le gestionnaire de processus Supervisor et Redis sur votre serveur Debian.

Dans cette première étape, vous installerez les dépendances d’ERPNext à partir du dépôt Debian. Ensuite, vous vérifierez également chaque dépendance pour vous assurer que tout est installé.

Avant d’installer les dépendances, exécutez la commande apt update ci-dessous pour rafraîchir votre index de paquets Debian.

sudo apt update

Maintenant, exécutez la commande suivante pour installer les dépendances pour ERPNext, y compris Python 3.11, Node.js, NPM, le serveur MariaDB, le serveur web Nginx, le gestionnaire de processus Supervisor et le serveur Redis.

sudo apt install python3-dev python3-venv nodejs yarnpkg npm redis-server mariadb-server nginx supervisor fail2ban libffi-dev git python3-pip python3-testresources libssl-dev wkhtmltopdf gcc g++ make

Tapez y pour continuer l’installation.

Une fois les dépendances installées, vérifiez chacune des dépendances en exécutant la commande suivante. Vous vérifierez certains services via la commande systemctl pour vous assurer que chaque service est en cours d’exécution et activé.

Vérifiez le serveur MariaDB en utilisant la commande suivante.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Vérifiez le service Nginx pour vous assurer que le service est en cours d’exécution et activé.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Maintenant, vérifiez le service du gestionnaire de processus Supervisor en utilisant la commande ci-dessous.

sudo systemctl is-enabled supervisor  
sudo systemctl status supervisor

Ensuite, vérifiez Redis pour vous assurer qu’il est disponible et prêt pour la production d’ERPNext.

sudo systemctl is-enabled redis-server  
sudo systemctl status redis-server

Ensuite, vérifiez les versions de Node.js et NPM en utilisant la commande suivante.

node --version  
npm --version

La sortie suivante confirme que Node.js v18.x et NPM 1.22 sont installés.

Enfin, vérifiez la version de wkhtmltopdf en utilisant la commande ci-dessous. Vous devriez voir que la version wkhtmltopdf 0.12 est installée.

wkhtmltopdf --version  
wkhtmltoimage --version

Configuration du serveur MariaDB

Après avoir installé les dépendances, vous configurerez votre serveur MariaDB pour vous assurer qu’il est prêt pour l’installation d’ERPNext. Le format barracuda requis par ERPNext doit être activé et le jeu de caractères par défaut configuré sur utf8mb4. Vous sécuriserez également votre serveur MariaDB via l’utilitaire mariadb-secure-installation.

Exécutez la commande mariadb-secure-installation ci-dessous pour sécuriser votre installation de serveur MariaDB.

sudo mariadb-secure-installation

Entrez Y pour appliquer lorsque vous êtes invité avec les configurations suivantes :

• Passer l’authentification locale à unix_socket ? Entrez n pour non.
• Configurer le mot de passe root de MariaDB ? Entrez y, puis tapez le nouveau mot de passe root de MariaDB et répétez.
• Supprimer l’utilisateur anonyme par défaut ? Entrez y pour confirmer.
• Désactiver la connexion à distance pour l’utilisateur root ? Entrez y pour confirmer.
• Supprimer la base de données de test par défaut ? Entrez y pour confirmer.
• Recharger les privilèges de table et appliquer les changements ? Entrez y pour confirmer.

Maintenant, ouvrez la configuration du serveur MariaDB /etc/mysql/mariadb.conf.d/50-server.cnf en utilisant l’éditeur nano suivant.

sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf

Insérez la configuration suivante dans la section [mysqld] pour activer le format barracuda et configurer le jeu de caractères par défaut sur utf8mb4.

[mysqld]  
innodb-file-format=barracuda  
innodb-file-per-table=1  
innodb-large-prefix=1  
character-set-client-handshake = FALSE  
character-set-server = utf8mb4  
collation-server = utf8mb4_unicode_ci

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Ensuite, ouvrez le fichier /etc/mysql/mariadb.conf.d/50-mysql-clients.cnf en utilisant l’éditeur nano pour configurer la connexion du client MariaDB.

sudo nano /etc/mysql/mariadb.conf.d/50-mysql-clients.cnf

Ajoutez la configuration suivante à la section [mysql].

[mysql]  
default-character-set = utf8mb4

Enregistrez et quittez le fichier.

Enfin, exécutez la commande suivante pour redémarrer le serveur MariaDB et appliquer la nouvelle configuration.

sudo systemctl restart mariadb

Installation de l’outil en ligne de commande Bench

Un bench est un outil en ligne de commande pour gérer les frameworks Frappe, y compris les applications et les sites. ERPNext est une application web écrite avec le framework Frappe, vous devez l’installer via Bench.

Complétez la section suivante pour créer un nouvel utilisateur qui sera utilisé pour ERPNext, puis installez l’utilitaire Bench sur votre système Debian.

Tout d’abord, exécutez la commande suivante pour ajouter un nouvel utilisateur frappe, entrez le nouveau mot de passe et répétez.

sudo useradd -m -s /bin/bash frappe  
sudo passwd frappe

Ajoutez l’utilisateur frappe au groupe sudo pour lui permettre d’exécuter la commande sudo.

sudo usermod -aG sudo frappe

Ensuite, connectez-vous en tant que nouvel utilisateur frappe et installez le package frappe-bench ou bench via le gestionnaire de paquets pip Python.

su - frappe  
sudo pip3 install frappe-bench --break-system-packages

Une fois le frappe-bench installé, vérifiez-le en utilisant la commande suivante. Dans cet exemple, bench 5.17 est installé à /usr/local/bin/bench.

which bench  
bench --version

Installation d’ERPNext via Bench

Dans cette section, vous installerez ERPNext via la ligne de commande Bench. Vous initialiserez le projet Frappe Framework, créerez un nouveau site, puis téléchargerez et installerez l’application ERPNext dans le projet Frappe.

Tout d’abord, exécutez la commande bench ci-dessous pour initialiser Frappe Framework 14 dans le répertoire frappe-bench.

bench init --python python3.11 --frappe-branch version-14 frappe-bench

Vous devriez voir le début de l’installation de Frappe Framework.

Une fois initialisé, vous devriez obtenir la sortie suivante :

Maintenant, exécutez la commande ci-dessous pour permettre aux utilisateurs d’exécuter le Framework Frappe. Cela permettra à des groupes tels que www-data d’exécuter le Framework Frappe.

sudo chmod -R o+rx /home/frappe/frappe-bench

Ensuite, déplacez-vous dans le répertoire d’installation de Frappe Framework ~/frappe-bench et créez un nouveau site erp.howtoforge.local.

cd ~/frappe-bench  
bench new-site erp.howtoforge.local --admin-password 'erpadmin' --mariadb-root-username root --mariadb-root-password 'password'

Voici la sortie que vous obtiendrez après la création du nouveau site.

Passez au nouveau site erp.howtoforge.local en exécutant la commande bench ci-dessous.

bench use erp.howtoforge.local

Une fois changé, vous devriez voir la sortie Current Site set to erp.howtoforge.local.

Maintenant, exécutez la commande bench ci-dessous pour télécharger les paiements et les prochaines applications.

bench get-app payments  
bench get-app --branch version-14 erpnext

Une fois erpnext téléchargé, exécutez la commande suivante pour l’installer sur le site erp.howtoforge.local. Cela installera également automatiquement l’application de paiements.

bench --site erp.howtoforge.local install-app erpnext

Après la fin de l’installation, exécutez la commande ci-dessous pour activer le planificateur et désactiver la maintenance sur le site erp.howtoforge.local.

bench --site erp.howtoforge.local enable-scheduler  
bench --site erp.howtoforge.local set-maintenance-mode off

À ce stade, ERPNext est installé, vous configurerez ERPNext en ajoutant Nginx comme proxy inverse et Supervisor comme gestionnaire de processus pour votre installation d’ERPNext.

Préparation d’ERPNext pour la production

Dans cette étape, vous configurerez ERPNext pour la production en configurant Nginx comme proxy inverse et Supervisor comme gestionnaire de processus, ce qui peut être fait automatiquement via Bench.

Exécutez la commande suivante pour configurer l’installation d’ERPNext. Cela téléchargera et installera Ansible, puis configurera automatiquement Nginx comme proxy inverse et le gestionnaire de processus Supervisor.

sudo pip3 install ansible --break-system-packages  
sudo bench setup production frappe

Voici une configuration automatique de Nginx et Supervisor pour votre installation d’ERPNext.

S’il y a une erreur, vous pouvez également configurer Nginx et Supervisor en utilisant la commande ci-dessous.

sudo bench setup supervisor  
sudo bench setup nginx  
sudo bench setup production frappe

Ensuite, redémarrez les services Nginx et Supervisor pour vous assurer que les nouveaux changements sont appliqués.

sudo systemctl restart nginx supervisor

Maintenant, exécutez la commande ci-dessous pour vérifier le service Nginx et vous assurer que le service est en cours d’exécution.

sudo systemctl status nginx

La sortie suivante indique que Nginx est en cours d’exécution.

Enfin, exécutez la commande supervisorctl ci-dessous pour vérifier la liste des processus ERPNext avec le Supervisor.

sudo supervisorctl status

Si tout se passe bien, vous devriez voir chaque processus avec le statut RUNNING.

Avec Nginx et Supervisor configurés, vous êtes prêt à commencer votre installation d’ERPNext depuis votre navigateur web.

Installation d’ERPNext via l’installateur web

Lancez votre navigateur web et visitez le nom de domaine de votre installation d’ERPNext, tel que http://erp.howtoforge.local/. Si votre installation d’ERPNext est réussie, vous devriez voir la page de connexion d’ERPNext.

Entrez l’utilisateur par défaut Administrator et le mot de passe que vous avez configuré, puis cliquez sur Login.

Sélectionnez la langue par défaut, le fuseau horaire, le pays et la devise. Ensuite, cliquez sur Next pour continuer.

Maintenant, entrez les détails de votre premier utilisateur ERPNext et cliquez sur Next.

Enfin, entrez les détails de votre organisation et cliquez sur le bouton Complete Setup pour terminer l’installation d’ERPNext.

Si votre installation est réussie, vous devriez obtenir le tableau de bord d’ERPNext comme suit :

Maintenant, l’installation d’ERPNext est terminée.

Conclusion

Félicitations ! Vous avez terminé l’installation d’ERPNext sur Debian 12 avec le serveur MariaDB et le serveur web Nginx. Vous avez installé ERPNext via la ligne de commande Bench sur votre serveur Debian, et maintenant vous pouvez utiliser ERPNext comme votre planification des ressources d’entreprise pour votre organisation.