Guide d’Installation d’ERPNext 15 sur Ubuntu 24.04

ERPNext est un logiciel open-source de gestion d’entreprise qui permet de gérer les différents aspects d’une entreprise tels que la comptabilité, la gestion des stocks, les ressources humaines, les ventes, et plus encore.

Il existe plusieurs façons d’installer ERPNext. Vous pouvez choisir entre :

1- ERPNext Cloud : Si vous ne voulez pas vous occuper de la gestion des serveurs, des dépendances ou des mises à jour, vous pouvez utiliser ERPNext Cloud. Des fournisseurs comme Frappe Cloud offrent un hébergement ERPNext géré, ce qui signifie que vous n’avez rien à installer localement. C’est la solution la plus simple.

2- Installation via Docker : Docker permet de déployer ERPNext dans un conteneur isolé, idéal pour les environnements de développement ou de test.

3- Installation avec Frappe Bench (recommandée pour les serveurs locaux) : L’option la plus courante et la plus recommandée pour installer ERPNext localement est d’utiliser Frappe Bench. Nous allons détailler cette méthode dans ce guide.

Prérequis

Il est recommandé d’installer ERPNext sur Ubuntu +22.04 ou Debian +12. Si vous ne disposez pas encore d’un système compatible, vous pouvez l’installer sur une machine virtuelle, comme VMware. Pour un fonctionnement optimal, prévoyez au moins 4 Go de RAM et 40 Go d’espace disque. Dans ce tutoriel, nous utiliserons Ubuntu 24.04.

Étape 1 : Mettre à jour le système

La première étape consiste à mettre à jour votre système pour vous assurer que tous les paquets sont à jour. Ouvrez votre terminal et exécutez les commandes suivantes :

sudo apt-get update -y
sudo apt-get upgrade -y
  • sudo : permet d’exécuter des commandes avec les droits administrateur (root).
  • apt-get update : met à jour la liste des paquets disponibles.
  • apt-get upgrade : installe les dernières versions des paquets.
  • -y : automatise l’installation en acceptant toutes les confirmations par défaut.

Étape 2 : Créer un utilisateur dédié pour ERPNext

Il est recommandé de ne pas installer ERPNext avec le compte root pour séparer les responsabilités et améliorer la sécurité du système. Nous allons créer un nouvel utilisateur pour l’installation et l’utilisation d’ERPNext que nous appellerons erpuser :

sudo adduser erpuser

Vous serez invité à définir un mot de passe pour cet utilisateur et à remplir des informations optionnelles. Ensuite, ajoutez cet utilisateur au groupe sudo pour lui donner des privilèges administratifs :

sudo usermod -aG sudo erpuser

Ensuite, passez à cet utilisateur avec la commande switch user :

su erpuser

Étape 3 : Installer les prérequis

Installer Git

Git est nécessaire pour cloner le dépôt d’ERPNext depuis GitHub. Exécutez la commande suivante :

sudo apt-get install git

Installer Python et les dépendances nécessaires

ERPNext 15 nécessite au moins la version +Python 3.11. Nous allons installer Python et les autres paquets et outils nécessaires avec les commandes suivantes :

sudo apt-get install python3-dev -y
sudo apt-get install python3-setuptools python3-pip -y
sudo apt install python3.12-venv -y
  • python3-dev : fournit les en-têtes et bibliothèques nécessaires pour compiler des modules Python.
  • python3-setuptools et python3-pip : ce sont des outils pour gérer les paquets Python.
  • python3.12-venv : permet de créer des environnements virtuels Python.

Installer Redis Server

Redis est un système de gestion de base de données en mémoire, utilisé pour la mise en cache et la gestion de sessions dans ERPNext. Installez-le avec :

sudo apt-get install redis-server

Installer MariaDB (base de données)

MariaDB est utilisé pour stocker toutes les données de l’application ERPNext. Installez-le avec :

sudo apt install mariadb-server -y

Une fois installé, sécurisez MariaDB en exécutant la commande suivante :

sudo mysql_secure_installation

Cela vous permettra de définir un mot de passe root et de sécuriser votre installation de base de données. choisissez :

  • Définir un mot de passe root.
  • Supprimer les utilisateurs anonymes. (Y)
  • Interdire la connexion root à distance. (N)
  • Supprimer la base de données de test. (Y)
  • Recharger les tables des privilèges. (Y)

Modifiez le fichier de configuration MariaDB :

sudo nano /etc/mysql/my.cnf

Ajoutez les lignes suivantes : 

[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
[mysql]
default-character-set = utf8mb4

Étape 4 : Installer CURL, Node.js, NPM et Yarn

ERPNext nécessite aussi Node.js et Yarn pour gérer les dépendances JavaScript et les tâches front-end.

sudo apt install curl
sudo apt-get install npm -y
curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash
source ~/.profile
nvm install 18
sudo npm install -g yarn -y

Autres dépendances

ERPNext a besoin d’autres paquets pour fonctionner correctement. Installez-les avec :

sudo apt-get install xvfb libfontconfig wkhtmltopdf -y
sudo apt install libmysqlclient-dev
  • wkhtmltopdf : permet de générer des PDF à partir de HTML, utilisé par ERPNext pour créer des rapports.
  • xvfb et libfontconfig : nécessaires pour la gestion de la mise en page et des polices.

Étape 5 : Installer Frappe Bench

Avant d’installer Frappe Bench, le framework qui facilite l’installation et la gestion d’ERPNext, nous allons d’abord installer pipx qui permet d’installer des applications Python dans un environnement isolé, évitant ainsi les conflits avec d’autres paquets. Grâce à pipx, nous pourrons installer frappe-bench proprement et l’exécuter comme une commande système.

sudo apt install pipx
pipx install frappe-bench

Une fois installé, nous devons ajouter le répertoire ~/.local/bin à notre PATH pour que les applications installées avec pipx soient accessibles globalement :

pipx ensurepath
source ~/.bashrc

Étape 6 : Créer un nouveau site ERPNext

Maintenant que toutes les dépendances sont installées, nous allons initialiser un nouveau site ERPNext. 

bench init frappe-bench --frappe-branch version-15
cd frappe-bench
bench new-site monsite

Pendant cette étape, vous serez invité à définir un mot de passe pour l’administrateur du site.

Étape 7 : Installer ERPNext et autres applications

Vous pouvez maintenant installer ERPNext et d’autres applications spécifiques à votre entreprise. 

bench get-app --branch version-15 erpnext
bench --site monsite install-app erpnext
bench get-app hrms
bench --site monsite install-app hrms
bench get-app payments

Étape 8 : Démarrer le serveur

Une fois l’installation terminée, choisissez quel site vous voulez utiliser puis démarrer le serveur ERPNext:

bench use monsite
bench start

Conclusion

Nous arrivons à la fin de ce guide pour installer ERPNext 15 sur Ubuntu 24.04 avec Frappe Bench. Si vous avez des questions ou des problèmes, n’hésitez pas à consulter la documentation officielle d’ERPNext ou à poser vos questions dans les forums dédiés.

Publications similaires

Retour en haut