To be able to send emails the Application Server needs to contact an SMTP (Simple Mail Transfer Protocol) server. This can be the SMTP server of your company or of your email provider (like Gmail, GMX etc).
To enable the Application Server to contact an SMTP server you have to specify some parameters in the Global settings. Table 1 gives a summary of SMTP related settings in the Global Settings.
The SMTP: Server and SMTP: Port setting define where the SMTP server is located and on which TCP port it is listening for requests. Note that if the Application Server is behind a firewall and the SMTP server is outside of the firewall you may have to configure your firewall to allow connections.
Setting name |
Description |
SMTP: Server |
Server to use for sending out email. This can be the IP-Address or DNS name of the server. E.g. smtp.mycompany.com or smtp.gmail.com |
SMTP: Port |
Port on which the smtp server listens. Non-SSL Servers often use port 25 SSL servers often 465 Default: 25 |
SMTP: User name |
Defines if communication with the SMTP server should be done over SSL Default: false |
Timeout |
Timeout when communicating with the SMTP Server, if the SMTP Server does not answer within that time the server is considered as down. Default: 30 |
SMTP: Sender address |
If SMTP: Use sender's email address is not set this email address is used as the From: address in all outgoing emails. If <%GS_SMTPREQUIREAUTHENTICATION%> is set this is used as the login for the SMTP server. Default: <empty> |
SMTP: Sender name |
If SMTP: Use sender's email address is not set this is used as the sender name in the From: field of all outgoing emails. |
User name |
The username for authenticating against the SMTP server Default: <empty> |
SMTP: Password |
Password used to login to the SMTP server Default: <empty> |
SMTP: Use sender's email address |
If set the email address of the user sending the message will be used in the From field of the sent emails. If not the SMTP: Sender address will be used an the user's email address will only be used as Reply-To address. |
SMTP: Allow attachments |
If not set the Application Server will not send Attachments via this SMTP Server. Unset this if your SMTP server does not allow to send attachments, the Application Server will then be adviced to remove attachments from outgoing emails so that they can still be delivered |
Table 1: Settings for SMTP configuration in the Global Settings
Using Googles SMTP service
Table 2 lists the settings needed to use Googles SMTP Service. Google implements a series of measures to secure the access to your Gmail account therefore you have to check the following points that might hinder you from using Googles SMTP service immediately.
Enable IMAP: In the email settings of your google mail account enable the IMAP protocol.
Password quality: Make sure your password is at least 7 characters and is strong (according to Google). If you have a weak password Google will not allow you to logon to the SMTP server.
Register sender: Google implements a security feature that might hinder you from connecting to the SMTP Server as long as you did not authenticate the computer from which you are sending. To register your computer, open a web browser on that computer and login to the Gmail web page. If the computer is not yet authenticated you will be guided through the necessary steps.
Setting |
Value |
SMTP: Server |
smtp.gmail.com |
SMTP: Port |
587 |
SMTP: User name |
Yes |
SMTP: Sender name |
The name of your google account (usually your gmail address. |
SMTP: Password |
The password of your google account |
Table 2: Global settings for using Google's SMTP Service
