Comment installer ERPNext sur Ubuntu 22.04

ERPNext est un logiciel ERP gratuit et open-source utilisé par les fabricants, distributeurs et services. Il est construit avec Python, JavaScript et le Frappe Framework. Il est moderne, facile à utiliser, gratuit et conçu pour les petites et moyennes entreprises qui aident les entreprises à gérer tous les aspects de leurs opérations commerciales. Des milliers d’entreprises dans le monde l’utilisent pour gérer leurs processus ERP. C’est l’un des meilleurs systèmes ERP qui prend en charge la fabrication, la distribution, le commerce de détail, le commerce, les services, l’éducation, les ONG, et plus encore.

Dans ce tutoriel, nous allons vous montrer comment installer le logiciel ERPNext sur un serveur Ubuntu 22.04.

Prérequis

Un serveur exécutant Ubuntu 22.04.
Un domaine valide pointé vers votre serveur.
Un mot de passe root configuré sur votre serveur.

Mise en route

Tout d’abord, vous devrez installer certaines dépendances Python sur votre système. Vous pouvez les installer toutes avec la commande suivante :

apt-get install python3-dev libffi-dev git python3-pip python3-testresources libssl-dev wkhtmltopdf gcc g++ make python3.10-venv -y

Une fois toutes les dépendances Python installées, vous devrez installer Node.js sur votre serveur.

Tout d’abord, ajoutez le dépôt Node.js avec la commande suivante :

curl -sL https://deb.nodesource.com/setup_16.x | bash -

Ensuite, installez Node.js et le serveur Redis avec la commande suivante :

apt-get install nodejs redis-server -y

Une fois les deux paquets installés, installez le paquet Yarn en exécutant la commande suivante :

npm install -g yarn

Une fois que vous avez terminé, vous pouvez passer à l’étape suivante.

Installer et configurer la base de données MariaDB

Par défaut, MariaDB est disponible dans le dépôt par défaut d’Ubuntu 22.04. Vous pouvez l’installer avec la commande suivante :

apt-get install mariadb-server -y

Une fois installé, sécurisez MariaDB et définissez le mot de passe root de MariaDB avec la commande suivante :

mysql_secure_installation

Répondez à toutes les questions comme indiqué ci-dessous pour définir le mot de passe root de MariaDB et sécuriser l’installation :

Entrez le mot de passe actuel pour root (appuyez sur Entrée pour aucun) :
Définir le mot de passe root ? [Y/n] Y
Nouveau mot de passe :
Ressaisissez le nouveau mot de passe :
Supprimer les utilisateurs anonymes ? [Y/n] Y
Interdire la connexion root à distance ? [Y/n] Y
Supprimer la base de données de test et l'accès à celle-ci ? [Y/n] Y
Recharger les tables de privilèges maintenant ? [Y/n] Y

Une fois MariaDB sécurisé, connectez-vous à la console MariaDB avec la commande suivante :

mysql -u root -p

Ensuite, vous devrez changer le format de fichier Innodb de MariaDB en Barracuda. Vous pouvez le faire en éditant le fichier /etc/mysql/mariadb.conf.d/50-server.cnf :

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

Ajoutez / Modifiez les lignes suivantes :

[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 et fermez le fichier, puis redémarrez le service MariaDB pour appliquer les modifications :

systemctl restart mariadb

Installer ERPNext sur Ubuntu 22.04

Tout d’abord, créez un nouvel utilisateur pour exécuter ERPNext en utilisant la commande suivante :

useradd -m -s /bin/bash erpnext

Ensuite, définissez le mot de passe pour ERPNext avec la commande suivante :

passwd erpnext

Ensuite, ajoutez l’utilisateur ERPNext au groupe sudo avec la commande suivante :

usermod -aG sudo erpnext

Ensuite, connectez-vous à l’utilisateur ERPNext et configurez la variable d’environnement avec la commande suivante :

su - erpnext  
nano ~/.bashrc

Ajoutez la ligne suivante :

PATH=$PATH:~/.local/bin/

Enregistrez le fichier puis activez la variable d’environnement avec la commande suivante :

source ~/.bashrc

Ensuite, créez un répertoire pour ERPNext avec la commande suivante :

sudo mkdir /opt/bench

Ensuite, définissez la propriété à l’utilisateur erpnext :

sudo chown -R erpnext:erpnext /opt/bench

Ensuite, changez le répertoire en /opt/bench et clonez le dépôt bench depuis Git Hub :

cd /opt/bench  
git clone https://github.com/frappe/bench bench-repo

Ensuite, installez le dépôt bench en utilisant la commande pip3 :

pip3 install -e bench-repo

Une fois installé, initialisez le répertoire bench avec le framework frappe en utilisant la commande suivante :

bench init erpnext

Vous devriez obtenir la sortie suivante :

? Built js/checkout.min.js
? Built js/dialog.min.js
? Built js/social.min.js
? Built js/web_form.min.js
? Built js/list.min.js
? Built js/chat.js
Browserslist: caniuse-lite is outdated. Please run next command `yarn upgrade caniuse-lite browserslist`
? Built css/frappe-rtl.css
? Built css/printview.css
? Built js/bootstrap-4-web.min.js
? Built js/barcode_scanner.min.js
? Built css/list.min.css
? Built css/report.min.css
? Built frappe/css/email.css
? Built js/frappe-recorder.min.js
? Built js/desk.min.js
? Built css/frappe-chat-web.css
? Built js/frappe-web.min.js
? Built css/form.min.css
? Built css/web_form.css
? Built css/desk.min.css
? Built css/frappe-web-b4.css
? Built js/control.min.js
? Built js/form.min.js
? Built js/data_import_tools.min.js
? Built js/report.min.js
?  Done in 111.35s
Done in 113.33s.
SUCCESS: Bench erpnext initialized

Ensuite, changez le répertoire en erpnext et créez un nouveau site ERPNext avec la commande suivante :

cd /opt/bench/erpnext  
bench new-site erp.example.com

On vous demandera de fournir votre mot de passe root de MariaDB et le mot de passe Administrateur comme indiqué ci-dessous :

Mot de passe root MySQL : 

Installation de frappe...
Mise à jour des DocTypes pour frappe        : [========================================] 100%
Mise à jour des informations sur le pays               : [========================================] 100%
Définir le mot de passe Administrateur : 
Ressaisissez le mot de passe Administrateur : 
* Le planificateur est désactivé *
Site actuel défini sur erp.example.com

À ce stade, ERPNext est installé sur votre système.

Configurer ERPNext pour l’environnement de production

Ensuite, vous devrez installer Supervisor pour gérer le processus ERPNext et configurer Nginx en tant que proxy inverse.

Tout d’abord, passez à l’utilisateur ERPNext puis installez Supervisor et Nginx avec la commande suivante :

su - erpnext  
sudo apt-get install supervisor nginx -y

Ensuite, installez le frappe-bench avec la commande suivante :

sudo pip3 install frappe-bench

Ensuite, changez le répertoire en /opt/bench/erpnext et configurez ERPNext pour l’environnement de production avec la commande suivante :

cd /opt/bench/erpnext  
sudo /home/erpnext/.local/bin/bench setup production erpnext

Une fois ERPNext configuré, vous devriez voir la sortie suivante :

PLAY RECAP ************************************************************************************************************************************
localhost                  : ok=8    changed=4    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0   

$ sudo systemctl restart supervisor
Liste de configuration des ports :

Site erp.example.com assigné au port : 80
$ /usr/bin/supervisorctl reread
Aucune mise à jour de configuration pour les processus
$ /usr/bin/supervisorctl update
$ sudo /usr/sbin/nginx -t
nginx : le fichier de configuration /etc/nginx/nginx.conf a une syntaxe correcte
nginx : le test du fichier de configuration /etc/nginx/nginx.conf est réussi
$ sudo systemctl reload nginx

À ce stade, ERPNext est configuré avec Nginx pour l’environnement de production.

Accéder à l’interface Web d’ERPNext

Maintenant, ouvrez votre navigateur Web et tapez l’URL http://erp.example.com. Vous serez redirigé vers la page de connexion d’ERPNext :

Connexion ERPNext

Fournissez le nom d’utilisateur comme Administrateur et un mot de passe que vous avez défini plus tôt et cliquez sur le bouton Connexion. Vous devriez voir la page suivante :

Sélectionner la langue

Sélectionnez votre langue souhaitée, Pays, Fuseau horaire et Devise, puis cliquez sur le bouton Suivant. Vous devriez voir la page suivante :

Créer un utilisateur

Fournissez votre nom, email, mot de passe et cliquez sur le bouton Terminer Configuration. Vous devriez voir le tableau de bord ERPNext sur la page suivante :

Tableau de bord ERPNext

Sécuriser ERPNext avec Let’s Encrypt SSL

Tout d’abord, vous devrez installer le client Certbot pour installer et gérer le SSL Let’s Encrypt. Vous pouvez l’installer avec la commande suivante :

sudo apt-get install certbot python3-certbot-nginx -y

Une fois installé, exécutez la commande suivante pour installer et configurer le SSL Let’s Encrypt pour votre domaine :

sudo certbot --nginx -d erp.example.com

On vous demandera de fournir votre email et d’accepter les conditions de service comme indiqué ci-dessous :

Enregistrement du journal de débogage dans /var/log/letsencrypt/letsencrypt.log
Plugins sélectionnés : Authenticator nginx, Installer nginx
Entrez l'adresse e-mail (utilisée pour les renouvellements urgents et les avis de sécurité) (Entrez 'c' pour annuler) : [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Veuillez lire les conditions de service à l'adresse https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. Vous devez
accepter afin de vous inscrire auprès du serveur ACME à l'adresse https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)ccepter/(C)annuler : A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Seriez-vous disposé à partager votre adresse e-mail avec la Electronic Frontier
Foundation, un partenaire fondateur du projet Let's Encrypt et l'organisation à but non lucratif
qui développe Certbot ? Nous aimerions vous envoyer des e-mails sur notre travail
pour chiffrer le web, des nouvelles de l'EFF, des campagnes et des moyens de soutenir la liberté numérique.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(O)ui/(N)on : Y
Obtention d'un nouveau certificat
Réalisation des défis suivants :
http-01 challenge pour erp.example.com
Attente de vérification...
Nettoyage des défis
Déploiement du certificat sur le VirtualHost /etc/nginx/conf.d/erpnext.conf

Ensuite, sélectionnez si vous souhaitez ou non rediriger le trafic HTTP vers HTTPS comme indiqué ci-dessous :

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1 : Pas de redirection - Ne faites aucune autre modification à la configuration du serveur web.
2 : Rediriger - Faites en sorte que toutes les demandes soient redirigées vers un accès HTTPS sécurisé. Choisissez ceci pour
les nouveaux sites, ou si vous êtes sûr que votre site fonctionne sur HTTPS. Vous pouvez annuler ce
changement en modifiant la configuration de votre serveur web.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Sélectionnez le numéro approprié [1-2] puis [entrer] (appuyez sur 'c' pour annuler) : 2

Tapez 2 et appuyez sur Entrée pour terminer le processus. Vous devriez voir la sortie suivante :

Redirection de tout le trafic sur le port 80 vers ssl dans /etc/nginx/conf.d/erpnext.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Félicitations ! Vous avez activé avec succès https://erp.example.com

Vous devriez tester votre configuration à l'adresse :
https://www.ssllabs.com/ssltest/analyze.html?d=erp.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

NOTES IMPORTANTES :
 - Félicitations ! Votre certificat et votre chaîne ont été enregistrés à :
   /etc/letsencrypt/live/erp.example.com/fullchain.pem
   Votre fichier clé a été enregistré à :
   /etc/letsencrypt/live/erp.example.com/privkey.pem
   Votre certificat expirera le 2022-09-11. Pour obtenir une nouvelle version ou une version modifiée
   de ce certificat à l'avenir, exécutez simplement certbot à nouveau
   avec l'option "certonly". Pour renouveler *tous* vos certificats de manière non interactive, exécutez "certbot renew"
 - Vos informations d'identification de compte ont été enregistrées dans votre répertoire de configuration Certbot à
   /etc/letsencrypt. Vous devriez faire une
   sauvegarde sécurisée de ce dossier maintenant. Ce répertoire de configuration contiendra également des certificats et des clés privées obtenus par Certbot, donc
   faire des sauvegardes régulières de ce dossier est idéal.
 - Si vous aimez Certbot, veuillez envisager de soutenir notre travail en :

   Faisant un don à ISRG / Let's Encrypt :   https://letsencrypt.org/donate
   Faisant un don à l'EFF :                    https://eff.org/donate-le

 - Nous n'avons pas pu vous abonner à la liste de diffusion de l'EFF car votre
   adresse e-mail semble invalide. Vous pouvez réessayer plus tard en
   visitant https://act.eff.org.

À ce stade, votre site Web ERPNext est sécurisé avec Let’s Encrypt SSL. Vous pouvez maintenant accéder à votre site Web en toute sécurité avec le protocole HTTPS.

Conclusion

Félicitations ! vous avez réussi à installer ERPNext avec Nginx et Let’s Encrypt SSL sur Ubuntu 22.04. N’hésitez pas à me poser des questions si vous en avez. Vous pouvez visiter la page de documentation d’ERPNext pour plus d’informations.