Configuring SMTP Settings¶

SMTP settings are defined in web.config under <system.net>.

Steps to Configure¶

Obtain SMTP details from the client’s mail or bulk mail provider.

Update

from address
host and port
userName and password.

Confirm that the web server can reach the SMTP host (firewall rules).

Testing¶

Identify a controller action that sends an email (e.g. a test notification).
Trigger the action and confirm delivery.
Check application logs and SMTP provider logs if issues occur.

Provider-specific requirements¶

Consult the service provider documentation to obtain additional requirements like TLS, Authentication Methods and specific ports required for smtp.

IMPORTANT¶

CONPROSOFT is considered a transactional system and therefore sends transactional emails. Some providers explicity excludes this form of email sending from their hosting packages. It is important to consult your domain and email service provider to ensure they do not blacklist your domain for excessive, often considered unsolicited, email sending.

On average, the system sends in excess of 60 emails a week. Some providers may require a bulk-email service to be purchased as an add-on to your hosting package.

Example Configuration¶

<system.net>
  <mailSettings>
    <smtp deliveryMethod="Network" from="no-reply@your-domain">
      <network host="smtp.your-provider.com"
               port="25"
               userName="smtp-user@your-domain.com"
               password="your-password" />
    </smtp>
  </mailSettings>
</system.net>