Configuring Mail

Liferay DXP/Portal can be configured to use a mail server to send email notifications for a variety of purposes: User registration and password management, Site membership notifications, and content updates. For demonstration purposes, you’ll walk through configuring the built-in mail session to use a Gmail server.

warning

If using the IMAP protocol for a category’s mailing list, make sure to configure the IMAP inbox to delete messages as they are pulled by the email client that sends messages to the users on the mailing list. Otherwise, each email message retained on the server is sent to the mailing list each time there’s a new post or update in the category.

Configuring the Built-in Mail Session

Follow these steps to configure the mail session from the Control Panel:

1. Sign in as the administrative user (the user specified on the Basic Configuration page).

2. Navigate to Control Panel → Configuration → Server Administration → Mail.

3. Enter your values for the following fields:

   • Incoming POP Server: pop.gmail.com
   • Incoming Port: 110
   • Use a Secure Network Connection: Flagged
   • User Name: joe.bloggs
   • Password: *****
   • Outgoing SMTP Server: smtp.gmail.com
   • Outgoing Port: 465
   • Use a Secure Network Connection: Flagged
   • User Name: joe.bloggs
   • Password: *****
   • Manually specify additional JavaMail properties to override the above configuration: If there are additional properties you need to specify, supply them here.

   

4. Click Save.

DXP connects to the mail session immediately.

Mail Configuration Reference

Field	Description
Incoming POP Server	The hostname for a server running the Post Office Protocol. DXP checks this mailbox for incoming messages, such as message board replies.
Incoming Port	The port on which the POP server is listening.
Use a Secure Network Connection	The checkbox to enable whether to use an encrypted connection when connecting to the POP server.
User Name	The user ID DXP uses to log into the POP server.
Password	The password DXP uses to log into the POP server.
Outgoing SMTP Server	The hostname for a server running the Simple Mail Transfer Protocol. DXP uses this server to send emails, such as password change emails and other notifications.
Outgoing Port	The port on which the SMTP server is listening.
Use a Secure Network Connection	Use an encrypted connection when connecting to the SMTP server.
User Name	The user ID DXP uses to log into the SMTP server.
Password	The password DXP uses to log into the SMTP server.
Manually specify additional JavaMail properties to override the above configuration	This field is for any additional JavaMail settings.

Related Topics

• Configuring Default Email Senders
• Alternative Email Configuration Methods
• Configuring Office 365 with OAuth