How to Configure EMail Server in SuiteCRM

Configuring the outgoing mail server in SuiteCRM is essential for sending email notifications, workflow alerts, and other email communications. This guide will walk you through the steps to set up your mail server without two-factor authentication (2FA), using either a Gmail account or an official mail server.

---

Step-by-Step Guide

Using Gmail (Without 2FA)

1. Disable 2FA for the Gmail Account:
   • If 2FA is enabled, disable it in your Google Account settings.
2. Enable “Less Secure App Access”:
   • Go to your Google Account settings.
   • Navigate to the “Security” section.
   • Scroll down to “Less secure app access” and turn it on.
3. Configure SuiteCRM:
   • Go to the Admin panel in SuiteCRM.
   • Select “Email Settings” from the options.
   • Fill in the following details:
     • From Name: SuiteCRM
     • From Address: your-email@gmail.com
     • SMTP Mail Server: smtp.gmail.com
     • SMTP Port: 587
     • Use SMTP Authentication: Yes
     • Enable SMTP over SSL or TLS: Select TLS
     • Username: your-email@gmail.com
     • Password: Enter your Gmail password
   • Save the settings.

Using Hostinger Mail Server (Without 2FA)

1. Ensure 2FA is Disabled:
   • Ensure that 2FA is not enabled on the official mail server account.
2. Configure SuiteCRM:
   • Go to the Admin panel in SuiteCRM.
   • Select “Email Settings” from the options.
   • Fill in the following details:
     • From Name: SuiteCRM
     • From Address: email@suitecrm.blog
     • SMTP Mail Server: smtp.hostinger.com (or your official mail server)
     • SMTP Port: 587
     • Use SMTP Authentication: Yes
     • Enable SMTP over SSL or TLS: Select TLS
     • Username: info@suitecrm.blog
     • Password: Enter the password for the official mail account
   • Save the settings.

Additional Settings

• Users may send as this account’s identity: Check this box if you want users to send emails using this email identity.
• Assignment Notifications: Enable if you want to send notifications when assignments are made.
• Email warning notifications: Enable if you want to receive warning notifications.
• Delete related notes & attachments with deleted Emails: Enable if you want to delete notes and attachments when emails are deleted.
• Send notification from the email address of the assigning user: Enable if you want notifications to come from the assigning user’s email.
• Opt In Settings: Configure based on your needs.
  • Disabled: Default option.
  • Automatically Send Opt In Email: Enable if you want automatic opt-in emails to be sent.
  • Confirm Opt In Email Template: Select the “Confirmed Opt In” template or create one if needed.
• Enable Legacy Email Compose Behaviour: Enable if you prefer the legacy email composing interface.

Email Security Settings

• Check all tags that should not be allowed in via InboundEmail or displayed in the Emails module. Recommended tags to block include:
  • <applet>
  • <base>
  • <embed>
  • <form>
  • <frame>
  • <frameset>
  • <iframe>
  • <import>
  • <layer>
  • <link>
  • <object>
  • <style>
  • <xmp>

---

FAQs

Q1: What do I do if I encounter an error saying “SMTP connection failed”?

A1: Ensure that you have entered the correct SMTP server details and that your email account does not have 2FA enabled. Verify that “Less secure app access” is enabled for Gmail accounts.

Q2: How can I test if my email configuration is working?

A2: After saving the email settings, you can use the “Send Test Email” feature available in the Email Settings page to verify that emails are being sent correctly.

Q3: Can I use other email providers apart from Gmail and official mail servers?

A3: Yes, you can use any email provider that supports SMTP. Ensure that the provider does not have 2FA enabled and that you have the correct SMTP server details.

Q4: What ports should I use for SMTP configuration?

A4: Common SMTP ports are 587 (for TLS) and 465 (for SSL). Ensure that you select the correct port based on the encryption method.

Q5: How can I enable notifications for specific users?

A5: In the “Email Settings” section, ensure that “Users may send as this account’s identity” is checked. Additionally, individual user settings can be configured in their profiles for notifications.

By following this guide, you should be able to configure the outgoing mail server in SuiteCRM successfully. If you encounter any issues, refer to the FAQs or contact your email provider for further assistance.