Email Settings

  • 1 month ago
  • 35 views
  • 0 comments

  • About 1 minute to read

Plato needs to send emails. Be it for account recovery, @mentions or notifications at some point you will likely need to allow Plato to send emails.

The Email settings page accessible via the Plato administrator dashboard let's you configure an SMTP server that Plato can use to send outbound emails. If emails are not configured you will see a warning as shown below...

settings-email.png

Configuring Your SMTP Server

  • Default Sender - Application generated emails will appear to be sent from this email address. The default sender for all application generated emails. For example noreply@company.com or support@company.com.
  • Server Address - The host name for your SMTP server.
  • Server Port - The port for your SMTP server.
  • Username If authentication is required provide your username.
  • Password - If authentication is required provide your password.
  • Enable TLS / SSL for SMTP Server - Tick to enable TLS whilst communicating with your SMTP Server

The username and password you provide so Plato can securely communicate with your SMTP server are stored securely within the Plato database using the data protection providers offered as part of .NET Core. Ultimately these details are stored, encrypted using AES.

Configuring Queue & Polling

To ensure the best possible performance Plato employs several techniques to ensure emails don't impact performance. Plato will queue emails that need to be sent within the Plato database and send these emails in batches periodically on a background thread.

Whilst normally not necessary you can customise this behaviour through the settings below...

  • Interval - The interval in seconds to poll the queue.
  • Batch Size - Number of emails to send per poll.
  • Send Attempts - Attempts before messages are deleted.
  • Enable Outbound Polling - If disabled emails will still be queued within the database but not sent - helpful for debugging or ensuring Plato does not send emails

Testing Emails

After you've configured your email settings you will see a new "Send Test Email" button in the bottom right of the Email Settings page. Use this button to send a test email using your configured SMTP server. If things are not configured correctly an error will be displayed when you use the "Send Test Email" button allowing you to troubleshoot further.

Can we improve this doc? Login or register to tell us how
Your Feedback
Cancel
In this doc