You're currently browsing the Ignition 8.0 docs. Click here to view the latest docs.


Gateway-Wide SMTP Server

In Ignition, there are several places that you might want to send an email from. Instead of setting up a new email server connection at each one, you can add SMTP server connections in the Gateway Config section and reference them in other places. For example, you can use a pre-configured connection in any of these places:

  • Alarm Notification - While the alarm notification system allows you to set up an Email Notification Profile that is separate from the SMTP Profile, you can instead choose to use the settings configured in the SMTP Profile.
  • Report Schedules - When Scheduling an Email Action in a report, the Action requires a configured SMTP Profile before the report can be emailed out.
  • system.net.sendEmail() - Instead of manually entering in values for the SMTP server inside each of your scripts, this function can instead use the settings from an existing SMTP Profile.

Once your SMTP Profile is set up, you only need to reference the name of the connection and Ignition will take care of the rest.

Setting up an SMTP Server

The Email Settings page allows you to configure an SMTP server connection that can be used by several different resources in the Gateway. This means that instead of setting up an SMTP server connection within each resource (i.e., Alarm Notification Profile, Reports, etc.), you can configure them once here, and have those resources all use the same SMTP server. You can find the Email Settings in the Config section of the Gateway under the Networking heading. Here, you can create a new SMTP Profile, or manage your existing profiles.

On this page ...

SMTP Profile Settings

Below is a list of properties available on an SMTP server connection. 

Property NameProperty Description
NameThe name of the SMTP profile.
DescriptionA description of the SMTP profile.
HostnameHostname of the SMTP server to send email through.
PortPort SMTP service is running on. Default is 25.
Use SSL/TLSConnect using dedicated SSL/TLS. Default is false.
Use STARTTLSEnable use of the STARTTLS command, allowing the connection to be upgraded to an SSL or TLS connection if supported by the server. This is not necessary for connections that are already SSL/TLS. Default is false.
UsernameThe username the Gateway will use when authenticating against the mailserver. This is only required if the SMTP server expects authentication.
PasswordThe password the Gateway will use when authenticating against the mailserver. This is only required if the SMTP server expects authentication.
PasswordRetype password for verification.
Advanced Properties
SMTP TimeoutTimeout (in milliseconds) to use when connecting to, reading from, and writing to the SMTP server. Default is 10,000.
Debug Mode EnabledEnable email session debugging. Information is printed to standard output (wrapper.log). Default is false.

SSL Protocols

The following feature is new in Ignition version 8.0.6
Click here to check out the other new features
A comma separated list of protocols that will be allowed if connecting via SSL/TLS. Default is TLSv1.2.



  • No labels