Guide d’installation d’ERPNext
ERPNext est un ERP open source basé sur Frappe Framework. Il permet de gérer les ventes, les achats, la comptabilité, les stocks, les ressources humaines, les projets et d’autres activités d’entreprise.
1. Installation locale sur Windows
Sur Windows, la méthode recommandée est d’utiliser Docker Desktop ou WSL2 avec Ubuntu.
Installe Docker Desktop pour Windows, active WSL2 si nécessaire, puis ouvre PowerShell ou Windows Terminal.
Commandes à utiliser :
git clone https://github.com/frappe/frappe_docker.git
cd frappe_docker
docker compose -f pwd.yml up -d
Une fois l’installation terminée, ouvre ERPNext dans ton navigateur avec l’adresse suivante :
http://localhost
2. Installation locale sur macOS
Sur macOS, la méthode la plus simple est également Docker Desktop.
Installe Docker Desktop, ouvre le Terminal, puis utilise les commandes suivantes :
git clone https://github.com/frappe/frappe_docker.git
cd frappe_docker
docker compose -f pwd.yml up -d
ERPNext sera ensuite accessible à cette adresse :
http://localhost
3. Installation locale sur Linux Ubuntu
Sur Linux, ERPNext peut être installé avec Frappe Bench. Cette méthode est recommandée pour les développeurs.
Commence par mettre le système à jour :
sudo apt update && sudo apt upgrade -y
Installe les dépendances nécessaires :
sudo apt install git python3-dev python3-pip redis-server nginx mariadb-server supervisor curl xvfb libfontconfig wkhtmltopdf -y
Installe Node.js et Yarn :
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash –
sudo apt install nodejs -y
sudo npm install -g yarn
Installe Frappe Bench :
sudo pip3 install frappe-bench
Crée l’environnement ERPNext :
bench init frappe-bench –frappe-branch version-15
cd frappe-bench
Crée un nouveau site ERPNext :
bench new-site erp.local
Télécharge et installe ERPNext :
bench get-app erpnext –branch version-15
bench –site erp.local install-app erpnext
Démarre ERPNext :
bench start
Accède ensuite à ERPNext depuis le navigateur :
http://localhost:8000
4. Installation d’ERPNext sur un VPS Ubuntu
Pour une installation en production, il est recommandé d’utiliser un VPS Ubuntu avec au minimum 4 Go de RAM, 2 vCPU et un stockage SSD.
Connecte-toi au serveur :
ssh root@IP_DU_SERVEUR
Crée un utilisateur dédié :
adduser frappe
usermod -aG sudo frappe
su – frappe
Installe les dépendances :
sudo apt update && sudo apt upgrade -y
sudo apt install git python3-dev python3-pip redis-server nginx mariadb-server supervisor curl xvfb libfontconfig wkhtmltopdf -y
Installe Node.js et Yarn :
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash –
sudo apt install nodejs -y
sudo npm install -g yarn
Installe Frappe Bench :
sudo pip3 install frappe-bench
Crée le projet ERPNext :
bench init frappe-bench –frappe-branch version-15
cd frappe-bench
Crée le site avec ton nom de domaine :
bench new-site erp.mondomaine.com
Installe ERPNext :
bench get-app erpnext –branch version-15
bench –site erp.mondomaine.com install-app erpnext
Active le mode production :
sudo bench setup production frappe
5. Configuration du nom de domaine
Dans la zone DNS de ton domaine, crée un enregistrement de type A qui pointe vers l’adresse IP du VPS.
Exemple :
erp.mondomaine.com → IP_DU_VPS
6. Activer HTTPS
Pour sécuriser le site avec HTTPS, installe Certbot :
sudo apt install certbot python3-certbot-nginx -y
Puis lance la configuration SSL :
sudo certbot –nginx
7. Commandes utiles
Mettre à jour ERPNext :
bench update
Redémarrer les services :
sudo supervisorctl restart all
sudo service nginx restart
Créer une sauvegarde :
bench –site erp.mondomaine.com backup
8. Sécurité recommandée
Pour un serveur VPS en production, il est conseillé d’utiliser un utilisateur non-root, d’activer le pare-feu, d’utiliser une clé SSH et de faire des sauvegardes régulières.
Commandes de base pour le pare-feu :
sudo ufw allow OpenSSH
sudo ufw allow 80
sudo ufw allow 443
sudo ufw enable
Conclusion
Pour tester ERPNext localement, Docker est la solution la plus simple sur Windows et macOS. Sur Linux, Frappe Bench offre plus de contrôle pour le développement. Pour une utilisation professionnelle, l’installation sur un VPS Ubuntu avec Nginx, Supervisor et HTTPS est la meilleure option.
ERPNext est une solution puissante pour centraliser la gestion commerciale, administrative et opérationnelle d’une entreprise dans un outil open source.