eXo Platform includes an email sending service that needs to be configured before it can function properly. This service, for instance, is used to send emails to users who forgot their password or username.
Configuring the outgoing email account
The email service can use any SMTP account configured in:
$PLATFORM_TOMCAT_HOME/gatein/conf/configuration.properties(in Tomcat).$PLATFORM_JBOSS_HOME/standalone/configuration/gatein/configuration.properties(in JBoss).
The relevant configurations are:
# Emails
gatein.email.domain.url=${domain.url:http://localhost:8080}
gatein.email.smtp.from=${smtp.from:noreply@exoplatform.com}
gatein.email.smtp.host=${smtp.host:localhost}
gatein.email.smtp.port=${smtp.port:25}
gatein.email.smtp.starttls.enable=${smtp.starttls.enable:false}
gatein.email.smtp.auth=${smtp.auth:false}
gatein.email.smtp.username=${smtp.username:}
gatein.email.smtp.password=${smtp.password:}
gatein.email.smtp.socketFactory.port=${smtp.socketFactory.port:} gatein.email.smtp.socketFactory.class=${smtp.socketFactory.class:}
| Domain name used to produce absolute URLs in email notifications. |
| Email display in "from" field of outgoing emails. |
| SMTP Server hostname. |
| SMTP Server port. |
| Set to true or false, true if you use the secure (TLS) SMTP. |
| Set to true or false, true to enable the SMTP authentication. |
| Username to send for authentication. |
| Password to send for authentication. |
| Specify the port to connect to when using the specified socket factory. |
| Use this class to create the SMTP sockets. |
All those configurations conform to a common format:
configuration.name=${variable:value}The variable appears here to allow you to set those configurations by exporting relevant environment variables. Refer to Customizing environment variables if you want to set the values via environment variables. Otherwise, just place the values after the colon (:).
If you want to use SMTP gateway over SSL, configure a certificate truststore containing your SMTP server's public certificate. Depending on the key sizes, you may then also need to install Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files for your Java Runtime Environment.
See also