Install the Magento Magepal SMTP extension

Before you can install any extension in Magento 2, you must create a Magento Marketplace account and an access key pair in the “Access Keys” section.

Once you have your Magento Marketplace keys ready, proceed to install the extension as follows:

  • At the console, install the Magepal SMTP extension using the commands below:

      $ cd /opt/bitnami/magento
      $ sudo composer require magepal/magento2-gmailsmtpapp

    The system will prompt for authentication. Use your Magento Marketplace keys as described in the Magento documentation and proceed to download the extension.

  • Once this process is complete, update the Magento configuration to add the new extension as shown below:

      $ sudo magento-cli module:enable --clear-static-content MagePal_Core MagePal_GmailSmtpApp
      $ sudo magento-cli setup:upgrade
  • Log in to the Magento administration panel.

  • Navigate to the “Stores -> Configuration” page.

  • Navigate to the “Magepal -> SMTP Configuration” section.

  • Set the “Enable” field to “Yes”.

  • Enter the details for your SMTP host. For example, use the following configuration for Gmail. Replace USERNAME and PASSWORD with your Gmail account username and password respectively.

      Authentication method: LOGIN
      SSL type: TLS
      SMTP Host: smtp.gmail.com
      SMTP Port: 587
      Username: USERNAME@gmail.com
      Password: PASSWORD
  • Use the “Test Email Server Configuration Settings” section to verify that your email configuration is correct.

  • Once verified, click “Save Config” to save the configuration.

For more information and troubleshooting, refer to the extension documentation.

NOTE: If you are using Gmail as the outbound email server, your application’s attempts to send outgoing emails may be blocked by Gmail if it considers the authentication attempts to be suspicious. When this happens, you will receive a Gmail security alert at the corresponding Gmail address. To proceed, you will need to manually confirm the validity of the authentication attempt before Gmail will permit the application to send outbound emails. For more information on this and other Gmail issues related to outbound email from your application, refer to our Gmail SMTP troubleshooting page.

Last modification September 11, 2023