Documentation

Connecting to a Mail Server

Liferay DXP 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, this article walks through configuring the built-in DXP mail session to use Gmail as its mail 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 DXP 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.

      Configuring a Mail Server

  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.