Configure the SMTP Server
Overview
Before email templates and other email features may be utilized, you must first enable and configure an SMTP server.
To enable and configure the SMTP server navigate to
.
Enable email by clicking on the Enabled toggle, and save your settings once you have completed your configuration.
SMTP Settings
- Host Optional defaults to
localhost
-
The hostname of the SMTP server. This will be provided by your SMTP provider.
- Port Optional defaults to
25
-
The port of the SMTP server. This will be provided by your SMTP provider. Ports
25
,465
and587
are the well known ports used by SMTP, it is possible your provider will utilize a different port.In most cases you will be using TLS to connect to your SMTP server, and the port will generally be
587
or465
. - Username Optional
-
The username used to authenticate to the SMTP server. This will be provided by your SMTP provider.
- Change password Optional
-
When enabled, you may modify the SMTP password, when the Password field is not displayed the current password will not be modified.
- Password Required
-
The new password to use for the outgoing SMTP mail server authentication. This field is only required when Change password is checked.
- Security Optional default is
None
-
The security type when using an SSL connection to the SMTP server. This value should be provided by your SMTP provider.
Generally speaking, if using port
25
you will selectNone
, if using port of465
you will selectSSL
and if using port587
you will selectTLS
. It is possible your provider will be different, follow your providers instruction.-
None
-
SSL
-
TLS
-
- Default from name Optional
-
The default From Name used in sending emails when a from name is not provided on an individual email template. This is the display name part of the email address ( i.e. Jared Dunn <jared@piedpiper.com>).
- Additional headers Optional Available since 1.32.0
-
One or more line separated SMTP headers to be added to each outgoing email. The header name and value should be separated by an equals sign. ( i.e.
X-SES-CONFIGURATION-SET=Value
).
SMTP Providers
SendGrid
This information is for starting guidance only - FusionAuth connects seamlessly with many different email providers. A deep exploration of email best practices and providers is outside the scope of this section.
SendGrid is a commonly used SMTP provider and integrates well with FusionAuth. To setup SendGrid, please follow the instructions below:
Other resources related to SendGrid are linked below:
Using dedicated IP addresses for any SendGrid account will build email reputation over time (improving email deliverability). And lastly, to control spoofing, phishing, and spam, it is recommended to set up SPF and DKIM records for the primary email domain (such as example-company.com
). Emails should also be sent from an address such as no-reply@example-company.com
.
Feedback
How helpful was this page?
See a problem?
File an issue in our docs repo
Have a question or comment to share?
Visit the FusionAuth community forum.