This website uses cookies to ensure you get the best experience. Learn More.
How to configure Google Mail in Liferay Portal
Configuring Liferay Portal to use Google Mail is relatively easy.
The key is to enable SSL socket connections.
The following article provides steps to enable Liferay Portal to send email via Google Mail.
To assist with tracing mail issue, please refer to related article How to trace mail in Liferay Portal.
The following mail configuration has been tested with these products:
The configuration may also be suitable for these products:
Configure mail settings in Liferay Portal using one of these approaches :
Establishing an email session with the Google Mail service requires a secure connection.
The default Liferay Portal 6.x mail configuration properties do not show how to establish a secure connection using additional mail SSL properties.
The mail SMTP properties "mail.session.mail.smtp.socketFactory" and "mail.session.mail.smtp.starttls.enable" are not defined in the default portal properties file "portal-impl.jar!portal.properties".
For the curious, the secure (SSL) and TLS properties are defined at runtime by Liferay Portal class com.liferay.util.mail.MailEngine
Add/update file "LIFERAY_HOME/portal-ext.properties" with the following mail session properties : FILE: LIFERAY_HOME/portal-ext.properties
mail.session.mail.pop3.host=pop.gmail.com mail.session.mail.pop3.password=PASSWORD mail.session.mail.pop3.port=110 mail.session.mail.pop3.user=USER mail.session.mail.imap.host=imap.gmail.com mail.session.mail.imap.port=993 mail.session.mail.store.protocol=imap mail.session.mail.transport.protocol=smtp mail.session.mail.smtp.host=smtp.gmail.com mail.session.mail.smtp.password=PASSWORD mail.session.mail.smtp.user=USER mail.session.mail.smtp.port=465 mail.session.mail.smtp.auth=true mail.session.mail.smtp.starttls.enable=true mail.session.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory
NOTE: Replace USER and PASSWORD with required user and password for Google Mail account.
Add/update file "LIFERAY_HOME/portal-ext.properies" with the following mail session properties : FILE: LIFERAY_HOME/portal-ext.properties
mail.session.jndi.name=mail/MailSession
Add/update file "LIFERAY_HOME/tomcat-xxx/conf/Catalina/localhost/ROOT.xml" with the following "Resource" element :
<Resource name="mail/MailSession" auth="Container" type="javax.mail.Session" mail.imap.host="imap.gmail.com" mail.imap.port="993" mail.pop.host="pop.gmail.com" mail.store.protocol="imap" mail.transport.protocol="smtp" mail.smtp.host="smtp.gmail.com" mail.smtp.port="465" mail.smtp.auth="true" mail.smtp.starttls.enable="true" mail.smtp.user=USER password=PASSWORD mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory" />
Sign in to Liferay Portal as admin user.
Navigate to "Control Panel > Server Administration > Mail"
Edit POP and SMTP mail settings.
eg.
Incoming POP Settings
Outgoing SMTP Server Settings
The contents of this section have moved to article How to trace mail in Liferay Portal