• View
• Edit
• History
• Print

Configuring gmail smtp server with Liferay

#############################

Problem

You want to send e-mails from Liferay, for instance send a new password if the user forgot the old one.

Solution

The simplest way is to use a Gmail account for this purpose. This way you don't need to set up a mail server on your machine.

First, create a dedicated Gmail account. Under Settings → Forwarding and POP/IMAP, you must enable POP and IMAP!

Then, if you use Liferay 5.2+, create the following file with this contents:

$LIFERAY/ROOT/WEB-INF/classes/portal-ext.properties :

mail.session.mail.store.protocol=imap
mail.session.mail.transport.protocol=smtp
#smtp properties
mail.session.mail.smtp.host=smtp.gmail.com
mail.session.mail.smtp.password=validpassword
mail.session.mail.smtp.user=validid@gmail.com

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

#mail.session.mail.smtp.socketFactory.fallback=false
#mail.session.mail.smtp.socketFactory.port=465
# Other protocols mail.session.mail.imap.host=localhost
mail.session.mail.pop3.host=localhost

Then restart Tomcat. You don't need to put the values between quotes. For the username you must add @gmail.com too.

Note

It was not easy to figure all this out…

Links:

• http://www.liferay.com/web/guest/community/wiki/-/wiki/Main/Configuring+gmail+smtp+server+with+Liferay (very useful)
• http://www.liferay.com/community/forums/-/message_boards/search?_19_breadcrumbsCategoryId=239393&_19_breadcrumbsMessageId=2132028&_19_threadId=2132029&_19_searchCategoryId=239393&_19_keywords=mail+server (forum threads on mail configuration)
• http://mail.google.com/support/bin/answer.py?answer=78799 (configuring other mail clients for working with Gmail)

The file portal.properties is in portal-impl.jar. The file portal-ext.properties that we created above overwrites some values.