It's recommended for Ubersmith-related email to be handled by the local MTA rather than talking SMTP to a remote host directly. It's quicker, with superior logging. This configuration will be done from a shell application, and is confirmed to work with Office 365, Sendgrid, and Amazon SES.


Ubersmith Mail container for Ubersmith 4.x

Copy your cacert.pem and paste it in /usr/local/ubersmith/conf/mail:

 Go to the mail container:

  • cd /usr/local/ubersmith; docker-compose exec mail bash

Modify /etc/postfix/main.cf to uncomment and edit the following variables to the appropriate settings:
/etc/postfix/main.cf Configuration Options

relayhost = [smtp.office365.com]:587
smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_sasl_security_options = noanonymous
smtp_sasl_tls_security_options = noanonymous
 
smtp_send_dummy_mail_auth = yes
smtp_always_send_ehlo = yes
smtp_tls_security_level = may
smtp_use_tls = yes
smtp_tls_CAfile = /etc/postfix/cacert.pem
 
# debug options
# debug_peer_list = smtp.office365.com

Create /etc/postfix/sasl_passwd and generate sasl_passwd.db:

Legacy Instructions for Ubersmith 3.x

These instructions also appear to work for relaying to Exim and postmarkapp.com.

This guide is functional on CentOS 6, which runs a pretty ancient version of Postfix – so it should hopefully also work with newer versions and OS'es.

  • Install the cyrus-sasl-plain package (or equivalent for the OS in question):
    • yum install cyrus-sasl-plain
  • Grab a copy of cacert.pem and drop it off in /etc/postfix
    • cd /etc/postfix; curl -L -O http://curl.haxx.se/ca/cacert.pem
  • Edit /etc/postfix/main.cf and include/update the following configuration options:


    /etc/postfix/main.cf Configuration Options

    relayhost = [smtp.office365.com]:587
    smtp_sasl_auth_enable = yes
    smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
    smtp_sasl_security_options = noanonymous
    smtp_sasl_tls_security_options = noanonymous
     
    smtp_send_dummy_mail_auth = yes
    smtp_always_send_ehlo = yes
    smtp_tls_security_level = encrypt
    smtp_use_tls = yes
    smtp_tls_CAfile = /etc/postfix/cacert.pem
     
    # debug options
    # debug_peer_list = smtp.office365.com


  • Edit /etc/postfix/sasl_passwd to contain the following:
    • [smtp.office365.com]:587    smtp-user@example.com:password
  • Run:
    • postmap /etc/postfix/sasl_passwd
  • Restart Postfix:
    • service postfix restart



On this page:


Related Topics 

Forwarding Emails





Document Stage
Audience
Author
Reviewer
Created Date
Updated Date
Version
Links
Graphics