Outgoing mail settings
    • 01 Nov 2022
    • 2 minutes to read

    Outgoing mail settings


    Article Summary

    It is possible to configure the settings for outgoing (sent) and incoming (received) messages from Totara.

    You can edit the outgoing mail configuration to your preferences by going to Quick-access menu > Server > Email > Outgoing mail configuration.

    Setting
    Description
    Notes

    SMTP hosts

    Give the full name of one or more local SMTP servers that Totara should use to send mail (e.g. 'mail.a.com' or 'mail.a.com;mail.b.com'). To specify a non-default port (i.e. other than port 25), you can use the [server]:[port] syntax (e.g. 'mail.a.com:587').

    For secure connections

    • Port 465 is usually used with SSL
    • Port 587 is usually used with TLS

    Specify security protocol below if required. If you leave this field blank, Totara will use the PHP default method of sending mail.

    -

    SMTP security

    If SMTP server requires secure connection, specify the correct protocol type.

    -

    SMTP Auth Type

    This sets the authentication type to use on SMTP server:

    • LOGIN
    • PLAIN
    • NTLM
    • CRAM-MD5
    • XOAUTH2

    -

    SMTP username

    If you have specified an SMTP server above, and the server requires authentication, then enter the username here.

    -

    SMTP password

    If you have specified an SMTP server above, and the server requires authentication, then enter the password here.

    -

    SMTP session limit

    Set the maximum number of messages sent per SMTP session. Grouping messages may speed up the sending of emails. Values lower than 2 force creation of new SMTP session for each email.

    -

    No-reply address

    Enter the email address to be included in the From field of all outgoing emails. This email address should usually match the user account for SMTP authentication. If this setting is empty or incorrect then outgoing emails are likely to get marked as spam or are not delivered at all.

    -

    Character set

    This setting specifies the default charset for all emails sent from the site.

    -

    Allow user to select character set

    If enabled, users can choose an email charset in their messaging preferences.

    -

    Allow attachments

    If ticked then it will enable emails sent from the site to have attachments, such as badges.

    -

    Newline characters in mail

    Newline characters used in mail messages. CRLF is required according to RFC 822bis, some mail servers do automatic conversion from LF to CRLF, other mail servers do incorrect conversion from CRLF to CRCRLF, yet others reject mails with bare LF (qmail for example). Try changing this setting if you are having problems with undelivered emails or double newlines.

    -

    Email via information

    Tick the box to add via information in the From section of outgoing email. This informs the recipient where the email came from and also helps combat recipients accidentally replying to no-reply email addresses.

    -

    OAuth2 Service

    This setting provides a list of configured OAuth2 services.

    -

    © Copyright 2024 Totara Learning Solutions. All rights reserved. Some content originally obtained via GPLv3 license and continues to be available under GPLv3. All other content is the sole copyright of Totara Learning Solutions. 


    Was this article helpful?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.