Log inCreate a free account

Language

Log inCreate a free account
Documentation menu

Dolibarr: SMTP server

Set up Dolibarr to send its emails through Mailcheer: SMTP/SMTPS sending method, port 587 with STARTTLS, credentials, then a real test email.

Dolibarr sends its emails with the sending method chosen in its setup. By default, that is PHP's mail function. This guide replaces it with an SMTP connection to Mailcheer. The labels are those of Dolibarr 24.0.1 in English, the latest release as of September 25, 2026.

Before you start

  • A domain verified in Mailcheer. Your sending address must belong to it. See Verify your domain.
  • Your Mailcheer SMTP credentials. In Mailcheer, open Integrations → From your website or software and click Create my credentials. The key is shown only once, so copy it right away.
  • A Dolibarr administrator account. The Setup menu is for administrators only. If the multicompany module is enabled, only the superadministrator can change the connection settings.

The values to enter

In the Parameters block:

Dolibarr settingValue
Sending methodSMTP/SMTPS socket library
SMTP/SMTPS Hostsmtp.mailcheer.com
SMTP/SMTPS Port587
Authentication methodUse a password (AUTH LOGIN)
SMTP username or ID (if sending server requires an authentication)mailcheer
SMTP password or token (if sending server requires an authentication)<your Mailcheer key>
Use TLS (SSL) encryptionNo
Use TLS (STARTTLS) encryptionYes

In the Other options block:

Dolibarr settingValue
Sender email for automatic emailsan address on your verified domain, for example contact@yourdomain.com

Prefer port 465? Enter 465 in SMTP/SMTPS Port, set Use TLS (SSL) encryption to Yes and Use TLS (STARTTLS) encryption to No.

On a Windows server, the host and port labels are longer and mention the default value from php.ini. They are the two rows right below Sending method.

Set up Dolibarr

  1. Log in with an administrator account and open Home → Setup → Emails.
  2. Click Modify at the bottom of the page.
  3. Under Sending method, choose SMTP/SMTPS socket library: the credential fields appear.
  4. Fill in the settings with the values from the tables above.
  5. Make sure Sender email for automatic emails is filled in: Dolibarr won't save without it.
  6. Click Save.

Emails you send yourself from Dolibarr go out, by default, with the address chosen in Default sender email preselected on forms to send emails: the user's email (User email) or the company's (Company Email). That address must also be on your verified domain.

Test it

  1. Back on the page, click Test server connectivity. If Dolibarr reaches Mailcheer, it shows "Server is available at address smtp.mailcheer.com on port 587". This test only checks the address and the port.
  2. Then click Test sending. In the form, pick an address on your verified domain under From, put your own address in To, and click Send email.
  3. Dolibarr confirms with "Email (from … to …) successfully accepted for delivery".
  4. As soon as that first email reaches Mailcheer, the Integrations → From your website or software page in Mailcheer shows that the connection works: Connected. It also lists recent rejections, with their reason.

If it doesn't work

  • "Server is not available at address … on port …" Check SMTP/SMTPS Host (smtp.mailcheer.com) and SMTP/SMTPS Port (587 or 465). Don't leave the port empty: Dolibarr would then use the standard port 25.
  • The port and the encryption don't match. With 587: STARTTLS on Yes, TLS (SSL) on No. With 465: the other way round. When you set one of them to Yes, Dolibarr switches the other back to No.
  • "Failed to send mail (sender=…, receiver=…)" Read the message that follows. Check your credentials: mailcheer in lowercase, and your Mailcheer key pasted again with no space at the start or the end. Also check that the address chosen under From is on a domain verified in Mailcheer.
  • The connection fields can't be edited. The multicompany module is enabled: they are reserved for the superadministrator.
  • The test works, but some emails are rejected. Read the reason shown in Mailcheer's recent rejections. If the sender is not on your verified domain, fix Sender email for automatic emails or Default sender email preselected on forms to send emails.

Sources