Setting Up Outgoing Email in Odoo 19

March 12, 2026 by
Setting Up Outgoing Email in Odoo 19
Liu
| No comments yet

Prerequisites

Before starting, ensure you have:

  1. Administrator Access to your Odoo 19 instance.
  2. SMTP Details from your email provider (Server address, Port, and SSL/TLS requirements).
  3. App Password (if using Gmail or Outlook with 2FA enabled).


Step 1: Enable Developer Mode

Odoo hides technical mail configurations by default. You must enable Developer Mode to access the necessary menus.

  1. Go to Settings.
  2. Scroll to the bottom and click Activate the developer mode.
  3. Once activated, a "bug" icon will appear in the top header.


Step 2: Configure Custom Email Servers

Odoo 19 requires you to explicitly allow custom servers if you are not using the default Odoo mail server.

  1. Navigate to Settings > General Settings.
  2. Find the Discuss or Emails section.
  3. Check the box for Use Custom Email Servers.
  4. Click Save.



Step 3: Create the Outgoing Mail Server

Now, you will input your provider's technical credentials.

  1. Go to Settings > Technical > Email > Outgoing Mail Servers.
  2. Click New.
  3. Fill in the following fields:
FieldDescriptionExample (Gmail)
DescriptionA name for the serverGmail - Company Main
SMTP ServerThe address of your mail providersmtp.gmail.com
SMTP PortUsually 465 (SSL) or 587 (TLS)465
Connection EncryptionChoose SSL/TLS or STARTTLSSSL/TLS
UsernameYour full email addressadmin@yourcompany.com
PasswordYour email password or App Passwordxxxx-xxxx-xxxx-xxxx


Step 4: Testing the Connection

This is the most critical step to ensure your settings are correct.

  1. Click the Test Connection button at the top left of the form.
  2. Success: A green notification will appear saying "Connection Test Succeeded! Everything seems properly set up."
  3. Failure: A red error message will appear. Common issues include:
    • Port 25 blocked: Many cloud providers block port 25. Use 465 or 587.
    • Authentication Failed: Double-check your App Password or 2FA settings.


Common SMTP Settings for Quick Reference

Google / Gmail
  • SMTP Server: smtp.gmail.com
  • Port: 465 (SSL) or 587 (TLS)
  • Security: SSL/TLS
  • Note: Requires an App Password generated in Google Security settings.
Microsoft Outlook / Office 365
  • SMTP Server: smtp.office365.com
  • Port: 587
  • Security: STARTTLS (TLS)
Setting Up Outgoing Email in Odoo 19
Liu March 12, 2026
Share this post
Archive
Sign in to leave a comment