Log inCreate a free account

Language

Log inCreate a free account
Documentation menu

Odoo: outgoing SMTP server

Send Odoo's emails through Mailcheer with an outgoing mail server on port 587 with STARTTLS, a FROM filter on your own domain, and a connection test.

Odoo sends its emails through an outgoing mail server. This guide creates one that goes through Mailcheer. It follows Odoo's official documentation for version 19.0, and uses the labels of the Odoo 19.0 interface in English.

On Odoo Online and Odoo.sh, Odoo sends through its own server out of the box. According to its documentation, an external outgoing server must be paired with your own domain, not with your database's …odoo.com subdomain.

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.
  • Access to Odoo's Settings.

The values to enter

Odoo fieldValue
NameMailcheer, or any name you like
FROM Filteringyour verified domain, for example yourdomain.com
Authenticate withUsername
Connection EncryptionTLS (STARTTLS), encryption and validation
SMTP Serversmtp.mailcheer.com
SMTP Port587
Usernamemailcheer
Password<your Mailcheer key>

Prefer port 465? Enter 465 in SMTP Port and pick SSL/TLS, encryption and validation under Connection Encryption.

By default, Odoo sets SMTP Port to 25 and Connection Encryption to None. Make sure you change both.

Create the server in Odoo

  1. Open Settings and scroll down to the Emails section.
  2. Enable Use Custom Email Servers, then click Save at the top of the page.
  3. Still in the Emails section, click Outgoing Email Servers, then New.
  4. Fill in the form with the values from the table above.

FROM Filtering decides which sender addresses Odoo routes through this server. Odoo's documentation notes that when it is left empty, emails go out with Odoo's notification address instead of the sender's.

Put Odoo's own addresses on your domain

Odoo builds some addresses itself, including the notification address (notifications@… by default). It also uses that address in place of the sender when the sender matches no filter. These addresses are built on the company's Alias Domain.

To have them on your verified domain: in Settings, Emails section, enter your domain in the Alias Domain field.

Test it

  1. At the top of the server form, click Test Connection. If all is well, Odoo shows "Connection Test Successful!".
  2. This button stops just before sending: no message goes out, and the sending address is not checked. Odoo's documentation also points out that a successful test alone does not guarantee your emails will go out. So send a real email from Odoo to an address of your own.
  3. 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

  • "An SMTP exception occurred. Check port number and connection security type." or "An SSL exception occurred…" The port and the encryption don't match. Two pairs work: 587 with TLS (STARTTLS), encryption and validation, or 465 with SSL/TLS, encryption and validation.
  • "No response received. Check server address and port number." Check smtp.mailcheer.com and the port. Port 25 is blocked on Odoo Online and Odoo.sh: use 587 or 465.
  • "Server replied with following exception:" followed by an authentication failure. The Username is mailcheer, in lowercase. For the Password, paste your Mailcheer key again, with no space at the start or the end.
  • The test passes, but Mailcheer rejects your emails. Read the reason shown in Mailcheer's recent rejections. If the sender is not on your verified domain, make sure FROM Filtering is exactly that domain, then check Alias Domain (see above).

Sources