SugarCRM SupportKnowledge BaseEmailConfiguring Your SMTP Server to Work With Sugar Cloud

Configuring Your SMTP Server to Work With Sugar Cloud


A lot of useful functionality (notifications, emails, campaigns, etc.) depends on SugarCRM being configured with an outbound email server (SMTP). Setting up an SMTP server in SugarCRM is as simple as navigating to Admin > Email Settings, choosing "SMTP" as the mail transfer agent, and entering the server information. A fully working setup, however, may require additional configuration on the email server.

Note: If you are sending from Sugar through an Exchange server, ensure that you have configured your SMTP Exchange server to accept "Basic Authentication".

Restricted IPs

Some email service providers restrict access to their servers to a predefined range of IP addresses. This means that the email server will only talk to a certain set of machines. You will need to speak with your system administrator, IT team, or email service provider to find out if access to your email server is restricted.

If your email server is restricted, please have the appropriate IP range added according to the following chart:

Instance is hosted on domain Instance is hosted on domain

Connections from your Sugar cloud server will be made from IP addresses in this range. Please be aware, this range of IP addresses may change in the future.

Note: This range of IP addresses only applies to instances hosted on Sugar's cloud service.

Error Messages

When encountering this issue, your Sugar log is likely to show the following error message:

[FATAL] SMTP -> ERROR: Failed to connect to server. Code: 111 Reply: Connection refused

A similar message may be displayed with the error code of 1.1.0. The cause of both is the same: the outbound email server is not accepting the request coming from Sugar, usually because the server is restricted to accepting requests from only a certain range of IP Addresses. These messages are relayed from your SMTP server back to Sugar and can be viewed in the Sugar logs. For more information, please refer to the article Troubleshooting Outbound Email Using Sugar Logs.

Last modified: 03/14/2018 05:39pm