Installation ERPNext v15

Guide complet pour installer ERPNext v15 sur Ubuntu 22.04 LTS. ERPNext v15 Ubuntu 22.04 Python 3.10+

Temps estimé : 30 à 60 minutes selon la vitesse de votre connexion internet et les ressources du serveur.

Prérequis

ComposantVersion requiseNotes
Ubuntu22.04 LTSServeur ou VM
RAM4 GB minimum8 GB recommandé
CPU2 vCPUs4 vCPUs recommandé
Disque40 GBSSD recommandé
Python3.10+Inclus dans Ubuntu 22.04
Node.js18.xInstallé via nvm
MariaDB10.6+MySQL non supporté
Redis6.x+Cache + Queue
Important : Toutes les commandes doivent être exécutées en tant qu'utilisateur non-root avec privilèges sudo. Ne jamais installer Frappe Bench en root.

Étape 1 — Préparation du Système

1

Créer un utilisateur dédié

sudo adduser frappe
sudo usermod -aG sudo frappe
su - frappe
2

Mettre à jour le système

sudo apt-get update && sudo apt-get upgrade -y
3

Installer les dépendances de base

sudo apt-get install -y \
  git python3-dev python3-pip python3-venv \
  python3-setuptools libffi-dev libssl-dev \
  libjpeg8-dev zlib1g-dev libxrender1 \
  fontconfig libfreetype6 libx11-6 libxext6 \
  xfonts-75dpi xfonts-base \
  wget curl software-properties-common \
  cron supervisor nginx

Étape 2 — Installation MariaDB

1

Installer MariaDB 10.6

sudo apt-get install -y mariadb-server mariadb-client
sudo systemctl start mariadb
sudo systemctl enable mariadb
2

Sécuriser MariaDB

sudo mysql_secure_installation

Répondez : Y à toutes les questions. Choisissez un mot de passe root fort.

3

Configurer MariaDB pour ERPNext

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

Ajoutez dans la section [mysqld] :

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

[mysql]
default-character-set = utf8mb4
sudo systemctl restart mariadb

Étape 3 — Node.js & Redis

1

Installer Node.js 18 via nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18
node --version  # Doit afficher v18.x.x
2

Installer Yarn

npm install -g yarn
3

Installer Redis

sudo apt-get install -y redis-server
sudo systemctl start redis-server
sudo systemctl enable redis-server
redis-cli ping  # Doit afficher PONG

Étape 4 — Installation de Frappe Bench

1

Installer Bench via pip

pip3 install frappe-bench

Si la commande bench n'est pas trouvée, ajoutez le path :

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
2

Initialiser un nouveau Bench

bench init --frappe-branch version-15 frappe-bench
cd frappe-bench
Cette étape télécharge Frappe Framework et crée l'environnement Python. Peut prendre 5-10 minutes.

Étape 5 — Création du Site

1

Créer un nouveau site

bench new-site mon-site.com \
  --db-root-password VOTRE_MOT_DE_PASSE_ROOT_MARIADB \
  --admin-password VOTRE_MOT_DE_PASSE_ADMIN

Remplacez mon-site.com par votre nom de domaine ou localhost pour les tests.

Étape 6 — Installation ERPNext

1

Télécharger ERPNext

bench get-app --branch version-15 erpnext
bench get-app --branch version-15 hrms  # Optionnel : module RH
2

Installer ERPNext sur le site

bench --site mon-site.com install-app erpnext
bench --site mon-site.com install-app hrms  # Si installé
3

Lancer le serveur de développement

bench start

Accédez à http://localhost:8000 — connectez-vous avec Administrator et votre mot de passe admin.

Étape 7 — Mode Production

1

Configurer Nginx et Supervisor

sudo bench setup production frappe
sudo bench setup nginx
sudo supervisorctl reread && sudo supervisorctl update
sudo service nginx reload
2

Configurer le site par défaut

bench --site mon-site.com set-config serve_default_site true
bench setup nginx
sudo service nginx reload

Étape 8 — Certificat SSL (Let's Encrypt)

1

Installer Certbot et générer le certificat

sudo apt-get install -y certbot python3-certbot-nginx
sudo bench setup lets-encrypt mon-site.com
Le domaine doit pointer vers votre serveur avant de générer le certificat SSL.

Post-Installation

Commandes utiles

# Redémarrer tous les services
bench restart

# Mettre à jour ERPNext
bench update

# Sauvegarder la base de données
bench --site mon-site.com backup

# Vider le cache
bench --site mon-site.com clear-cache

# Voir les logs
bench logs

Dépannage

Erreur : "Command 'bench' not found"

export PATH="$HOME/.local/bin:$PATH"
source ~/.bashrc

Erreur MariaDB : "Access denied for user root"

sudo mysql -u root
ALTER USER 'root'@'localhost' IDENTIFIED BY 'nouveau_mot_de_passe';
FLUSH PRIVILEGES;
EXIT;

Workers ne démarrent pas

sudo supervisorctl status
sudo supervisorctl restart all
bench --site mon-site.com clear-cache
Besoin d'aide ? Notre équipe LSI installe et configure ERPNext v15 pour vous en 48h. Contactez-nous →