Set up the message transfer agent (MTA)

Last updated Wednesday, April 19, 2017 in Email Experience Manager for Developer
Keywords: Sending

For email delivery, you can choose to use the Sitecore MTA or the Custom SMTP. The default provider is Sitecore MTA.

Use the Sitecore MTA

You can switch to the Sitecore MTA by disabling the CustomSmtp configurations and then enabling the Dyn configurations.

Before you switch to using the Sitecore MTA:

  • Make sure the firewall on your server does not block the following URL's:
    • https://apps.sitecore.net
    • smtp.dynect.net
    • https://emailapi.dynect.net
  • Open the ports 587 and 443 for the following URL's:
    • https://sitecore.smtp.e.sparkpost.com
    • https://sitecore.api.e.sparkpost.com
  • If you want to enable the Transport Layer Security (TLS), in the App_Config\Include\EmailExperience\Sitecore.EDS.Providers.Dyn.config file, in the section sitecore/exm/eds/smtpSettings:
    • In the setting <port> specify the relevant port. You can use port 25 or port 587.
    • Add the setting <startTls>true</startTls>.

To switch to use the Sitecore MTA:

  1. Verify your App Center subscription for Email Delivery. 
  2. In the Website\App_Config\Include\EmailExperience folder, add the suffix .disabled to the following files: 
    • Sitecore.EDS.Providers.CustomSmtp.config  
    • Sitecore.EDS.Providers.CustomSmtp.Sync.config 
  3. In the Website\App_Config\Include\EmailExperience folder, remove the suffix .disabled from the following files:
    • Sitecore.EDS.Providers.Dyn.config.disabled 
    • Sitecore.EDS.Providers.Dyn.Sync.config.disabled

Use a Custom SMTP

To switch from using the Sitecore MTA to using the Custom SMTP, you must disable the Dyn configurations and then enable the CustomSmtp configurations:

  1. In the Website\App_Config\Include\EmailExperience folder, add the suffix .disabled to the end of the following file names:
    • Sitecore.EDS.Providers.Dyn.config 
    • Sitecore.EDS.Providers.Dyn.Sync.config 
  2. In the  Website\App_Config\Include\EmailExperience folder, remove the suffix .disabled from the following file names: 
    • Sitecore.EDS.Providers.CustomSmtp.config.disabled  
    • Sitecore.EDS.Providers.CustomSmtp.Sync.config.disabled 
  3. Open the enabled configuration files and configure your SMTP and POP3 servers.
Send feedback about the documentation to docsite@sitecore.net.