You are here

Outbound SMTP configuration properties

The following properties can be configured for the Outbound SMTP subsystem type.
Note: You must set the Outbound email configuration for Alfresco Share invitations to work correctly. If you do not set the email configuration, when you invite a user to a site, the user will not receive the assigned task notification.

The email service is exposed as a spring bean called mailService, which is contained in the Outbound SMTP subsystem.

Configure the repository to send emails to an external SMTP server by overriding the default settings. Set the email property overrides in the file.
Specifies the host name of the SMTP host, that is, the host name or IP address of the server to which email should be sent.
Specifies the port number on which the SMTP service runs (the default is 25). By convention, the TCP port number 25 is reserved for SMTP, but this can be changed by your email administrator.
Specifies the user name of the account that connects to the smtp server.
Specifies the password for the user name used in mail.username.
Specifies UTF-8 encoding for email. Set this value to UTF-8 or similar if encoding of email messages is required.
Specifies the email address from which email notifications are sent. This setting is for emails that are not triggered by a user, for example, feed notification emails. If the current user does not have an email address, this property is used for the from field by the MailActionExecutor.
If this property is set to false, then the value set in mail.from.default is always used. If this property is set to true, then the from field may be changed. This property may be required if your email server security settings insist on matching the from field with the authentication details.
Specifies which protocol to use for sending email. The value can be either smtp or smtps.
Optionally specifies the content transfer encoding for the message. If specified the Content-Transfer-Encoding is set to the value you specify.
The following properties are for SMTP.
Specifies if authentication is required or not. Specifies the use of SMTPS authentication. If true, attempt to authenticate the user using the AUTH command. Defaults to false.
Specifies the timeout in milliseconds for SMTP.
Specifies if the transport layer security needs to be enabled or not. Specifies the use of STARTTLS command. If true, enables the use of the STARTTLS command to switch the connection to a TLS-protected connection before issuing any login commands. Defaults to false.
Specifies if debugging SMTP is required or not.
The following properties are for SMTPS.
Specifies if the transport layer security for smtps needs to be enabled or not.
Specifies if authentication for smtps is required or not.

The following properties can be set to define a test message when the subsystem starts.

Defines whether or not to send a test message.
Specifies the recipient of the test message.
Specifies the message subject of the test message.
Specifies the message body of the test message.

The following property is for setting the email site invitation behavior.
You must set the outbound email configuration for Share invitations to work correctly. This property allows you to control whether or not emails are sent out for site invites. If you have not configured the outbound email properties, set this property to false.

The following examples show which properties to set for two different email clients. Add these properties to the file.

The following example shows the properties that you need to set to configure Gmail.
# Sample Gmail settings
The following example shows the properties that you need to set to configure Zimbra.
# Sample Zimbra settings
Not authenticated.<your company>
# Set this value to UTF-8 or similar for encoding of email messages as required
# Set this value to 7bit or similar for Asian encoding of email headers as required
mail.from.default=<default from address>

Sending feedback to the Alfresco documentation team

You don't appear to have JavaScript enabled in your browser. With JavaScript enabled, you can provide feedback to us using our simple form. Here are some instructions on how to enable JavaScript in your web browser.