Ajouter des domaines personnalisés à un site

Un site peut recevoir plusieurs domaines, avec ou sans certificat. La configuration nginx doit être régénérée puis rechargée.

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

À quoi sert la commande

Un site peut recevoir plusieurs domaines personnalisés :

terminal

bench setup add-domain [desired-domain]

La commande demande ensuite pour quel site le domaine doit être défini.

Certificat

Deux options posent le certificat SSL du domaine :

terminal

--ssl-certificate [path-to-certificate]
--ssl-certificate-key [path-to-certificate-key]

Exemple :

terminal

bench setup add-domain custom.erpnext.com --ssl-certificate /etc/letsencrypt/live/erpnext.cert --ssl-certificate-key /etc/letsencrypt/live/erpnext.key

La configuration est enregistrée dans le site_config.json du site, dans la liste domains. Chaque entrée peut porter domain, ssl_certificate et ssl_certificate_key.

json

"domains": [
  {
    "ssl_certificate": "/etc/letsencrypt/live/erpnext.cert",
    "domain": "erpnext.com",
    "ssl_certificate_key": "/etc/letsencrypt/live/erpnext.key"
  }
]

Point d’attention

Le domaine n’est pas pris en compte tant que la configuration nginx n’est pas régénérée, puis le service rechargé :

terminal

bench setup nginx
sudo service nginx reload