JBoss.orgCommunity Documentation

Mail server

Note

The Mail portlet and its services are deprecated. It remains fully supported for eXo customers, however it will not receive any enhancement and will be removed from the product scope in the future.

eXo Platform requires the SMTP server to send emails, such as notifications or password reminders.

The Email service can use any SMTP account that needs to be configured in /server/default/conf/gatein/configuration.properties (Or $TOMCAT_HOME/ gatein/conf/configuration.properties if you are using Tomcat).

The relevant section looks like:

#EMail
# Domain name: Help for sending links from email notifications. The default domain name is http://localhost:8080.
gatein.email.domain.url=http://localhost:8080
# Email display in "from" field of email notification.
gatein.email.smtp.from=noreply@exoplatform.com
gatein.email.smtp.username=
gatein.email.smtp.password=
gatein.email.smtp.host=smtp.gmail.com
gatein.email.smtp.port=465
gatein.email.smtp.starttls.enable=true
gatein.email.smtp.auth=true
gatein.email.smtp.socketFactory.port=465
gatein.email.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory

Some authenticated SMTP systems, such as GMail, GMX, MS Exchange, require the value for 'sender' or 'from' in the email message that must be identical to the SMTP user and host.

The Forum application uses it in the notification phase as the default sender. If it is not set, the sender will be empty.

gatein.email.domain.url Domain name.
gatein.email.smtp.from Sender's email address.
gatein.email.smtp.host SMTP hostname.
gatein.email.smtp.port SMTP port.
gatein.email.smtp.starttls.enable True to enable the secure (TLS) SMTP. See RFC 3207.
gatein.email.smtp.auth True to enable the SMTP authentication.
gatein.email.smtp.username Username to send for authentication.
gatein.email.smtp.password Password to send for authentication.
gatein.email.smtp.socketFactory.port Specify the port to connect to when using the specified socket factory.
gatein.email.smtp.socketFactory.class This class will be used to create SMTP sockets.

To see more details, refer to JavaMail API documentation.

For Knowledge, you have to modify the following properties to the configuration file /gatein/conf/configuration.properties to make sure that this mail service works with the authenticated SMTP systems:

gatein.email.domain.url=http://localhost:8080
gatein.email.smtp.from=noreply@exoplatform.com

Note

The value of email address should be in a valid format.