Mise en production

Le script d’installation avec le drapeau production pose le bench. Le site répond sur son domaine si le DNS pointe vers le serveur.

2 min de lectureMis à jour le 5 octobre 2026Source : docs.frappe.io

Installer bench

Bench gère les déploiements de sites Frappe. Le déploiement ressemble à une installation locale. Sur Debian, Ubuntu ou CentOS, le script Easy Install du dépôt bench s’utilise avec --production :

terminal

sudo python install.py --production --user [frappe-user]

La configuration Supervisor et nginx à la main est dans Mise en production.

Sites et applications

terminal

cd frappe-bench
bench new-site example.com
bench get-app erpnext
bench get-app https://github.com/yourremote/yourapp.git
bench --site example.com install-app erpnext yourapp

bench new-site est détaillé dans bench new-site.

Supervisor

sudo supervisorctl status doit montrer les processus : trois Redis (cache, queue, socketio), le web, node-socketio, les workers default, long et short, et le schedule. Si example.com pointe vers l’adresse du serveur, le site est en ligne.

Mise à jour

bench update met à jour toutes les applications (git pull), lance les patches, construit JS et CSS, et redémarre Supervisor.

Commande	Effet
`bench update --pull`	Applications
`bench update --patch`	Patches seulement
`bench update --build`	Assets seulement
`bench update --bench`	Le CLI bench
`bench update --requirements`	Paquets Python et node_modules

Espaces de noms Redis

Ils isolent les données. Plusieurs bench peuvent partager un Redis sans collision. Pour l’instant, Frappe ne gère les espaces de noms que pour Redis Queue, au niveau du bench.

bench create-rq-users crée les utilisateurs Redis. --use-rq-auth active l’authentification pour tous les sites du bench. --set-admin-password fixe le mot de passe de l’utilisateur admin. Un fichier ACL est écrit dans la configuration du bench. redis_queue.conf doit le citer, par aclfile vers config/redis_queue.acl. Sinon, bench setup redis avec un CLI récent le prépare.

Point d’attention

Sans le drapeau --production du script, cette page ne décrit pas la suite Supervisor. bench update sans option fait le cycle complet, redémarrage compris.