Se connecterCréer un compte gratuit

Langue

Se connecterCréer un compte gratuit
Menu de la documentation

Dolibarr : serveur SMTP

Réglez Dolibarr pour envoyer ses e-mails par Mailcheer : méthode SMTP/SMTPS, port 587 en STARTTLS, identifiants, puis un vrai e-mail de test.

Dolibarr envoie ses e-mails selon la méthode d'envoi choisie dans sa configuration. Par défaut, c'est la fonction mail de PHP. Cette fiche la remplace par une connexion SMTP à Mailcheer. Les libellés sont ceux de Dolibarr 24.0.1 en français, dernière version publiée au 25/09/2026.

Avant de commencer

  • Un domaine vérifié dans Mailcheer. L'adresse d'expédition doit appartenir à ce domaine. Voir Vérifier votre domaine.
  • Vos identifiants SMTP Mailcheer. Dans Mailcheer, ouvrez Intégrations → Depuis votre site ou votre logiciel et cliquez sur « Créer mes identifiants ». La clé ne s'affiche qu'une fois : copiez-la tout de suite.
  • Un compte administrateur Dolibarr. Le menu « Configuration » est réservé aux administrateurs. Si le module multi-société est activé, seul le super-administrateur peut modifier les réglages de connexion.

Les valeurs à saisir

Dans le bloc « Paramètres » :

Paramètre dans DolibarrValeur
« Méthode d'envoi »« SMTP/SMTPS socket library »
« Hôte SMTP/SMTPS »smtp.mailcheer.com
« Port SMTP/SMTPS »587
« Méthode d'authentification »« Utilisez un mot de passe (AUTH LOGIN) »
« Nom d'utilisateur ou identifiant SMTP (si le serveur d'envoi nécessite une authentification) »mailcheer
« Mot de passe ou token SMTP (si le serveur d'envoi nécessite une authentification) »<votre clé Mailcheer>
« Utiliser le chiffrement TLS (SSL) »« Non »
« Utiliser le chiffrement TTS (STARTTLS) »« Oui »

« TTS » est bien écrit ainsi dans la version française de Dolibarr : c'est la ligne STARTTLS.

Dans le bloc « Autres options » :

Paramètre dans DolibarrValeur
« E-mail de l'expéditeur pour les e-mails automatiques »une adresse de votre domaine vérifié, par exemple contact@votredomaine.fr

Vous préférez le port 465 ? Saisissez 465 dans « Port SMTP/SMTPS », mettez « Utiliser le chiffrement TLS (SSL) » sur « Oui » et « Utiliser le chiffrement TTS (STARTTLS) » sur « Non ».

Sur un serveur Windows, les libellés de l'hôte et du port sont plus longs et rappellent la valeur par défaut de php.ini. Ce sont les deux lignes placées sous « Méthode d'envoi ».

Configurer Dolibarr

  1. Connectez-vous avec un compte administrateur et ouvrez Accueil → Configuration → Emails.
  2. Cliquez sur « Modifier », en bas de la page.
  3. Dans « Méthode d'envoi », choisissez « SMTP/SMTPS socket library » : les champs d'identification apparaissent.
  4. Remplissez les paramètres avec les valeurs des tableaux ci-dessus.
  5. Vérifiez que « E-mail de l'expéditeur pour les e-mails automatiques » est rempli : Dolibarr refuse d'enregistrer sans lui.
  6. Cliquez sur « Enregistrer ».

Les e-mails que vous envoyez vous-même depuis Dolibarr partent par défaut avec l'adresse choisie dans « Expéditeur par défaut présélectionné sur les formulaires pour envoyer des e-mails » : l'e-mail de l'utilisateur (« Email utilisateur ») ou celui de la société (« Email organization »). Cette adresse doit, elle aussi, être sur votre domaine vérifié.

Tester

  1. De retour sur la page, cliquez sur « Tester disponibilité serveur ». Si Dolibarr joint Mailcheer, il affiche « Serveur disponible à l'adresse smtp.mailcheer.com sur le port 587 ». Ce test vérifie seulement l'adresse et le port.
  2. Cliquez ensuite sur « Tester envoi ». Dans le formulaire, choisissez dans « De » une adresse de votre domaine vérifié, mettez votre propre adresse dans « Adressé à », puis cliquez sur « Envoyer email ».
  3. Dolibarr confirme par « E-mail (de … vers …) accepté pour expédition ».
  4. Dans Mailcheer, dès que ce premier e-mail arrive, la page Intégrations → Depuis votre site ou votre logiciel indique « Branché ». Elle montre aussi les refus récents, avec leur raison.

Si ça ne marche pas

  • « Serveur non disponible à l'adresse … sur le port … » Vérifiez « Hôte SMTP/SMTPS » (smtp.mailcheer.com) et « Port SMTP/SMTPS » (587 ou 465). Ne laissez pas le port vide : Dolibarr utiliserait le port standard 25.
  • Le port et le chiffrement ne vont pas ensemble. Avec 587 : STARTTLS sur « Oui », TLS (SSL) sur « Non ». Avec 465 : l'inverse. Quand vous passez l'un des deux sur « Oui », Dolibarr remet l'autre sur « Non ».
  • « Échec de l'envoi de l'email (émetteur=…, destinataire=…) » Lisez le message qui suit. Vérifiez les identifiants : mailcheer en minuscules, et la clé Mailcheer recollée sans espace au début ni à la fin. Vérifiez aussi que l'adresse choisie dans « De » est sur votre domaine vérifié dans Mailcheer.
  • Les champs de connexion ne sont pas modifiables. Le module multi-société est activé : ils sont réservés au super-administrateur.
  • Le test passe, mais certains e-mails sont refusés. Regardez la raison affichée dans les refus récents de Mailcheer. Si l'expéditeur n'est pas sur votre domaine vérifié, corrigez « E-mail de l'expéditeur pour les e-mails automatiques » ou « Expéditeur par défaut présélectionné sur les formulaires pour envoyer des e-mails ».

Sources