Configuring SMTP

    The Hudu admin area is accessible ONLY to admins and super admin users within your organization.

You can configure your SMTP server by going to the Hudu admin area >> Email Setup

You will see three configuration options:

  • Default
    • What is configured in your .env file (not editable via the UI).
  • Custom SMTP
    • For custom SMTP server configuration.
  • Microsoft Graph

   Self-Hosted Only: If you plan to use unauthenticated SMTP, configure the necessary settings in your .env file and ensure that your are selecting the Default configuration option. Leave the username and password fields blank in the environment file and make sure AUTHENTICATION= is set to none. To save the changes, you will need to take Docker down and back up.

    Action required: Exchange Online will permanently remove support for Basic authentication with Client Submission (SMTP AUTH) gradually beginning with a small percentage of submission rejections for all tenants on March 1st 2026 and reaching 100% rejections on April 30th 2026 (previously September 2025). After this time, applications and devices will no longer be able to use Basic auth as an authentication method and must use OAuth when using SMTP AUTH to send email. Learn more from Microsoft.

Guides

Example Settings for Different Providers

 

Amazon SES 

  • SMTP DOMAIN: mywebsite.com
  • SMTP SERVER ADDRESS: email-smtp.us-east-1.amazonaws.com
  • SMTP USERNAME: Username
  • SMTP PASSWORD: afdsafsfdsadfs
  • SMTP PORT: 587
  • AUTHENTICATION: LOGIN
  • USE TLS: CHECKED/TRUE
  • VERIFY MODE: none
  • SMTP FROM ADDRESS: hi@mywebsite.com
  • SMTP DISPLAY NAME: Example Support Team

 

SMTP2GO

  • SMTP DOMAIN: mywebsite.com
  • SMTP SERVER ADDRESS: mail.smtp2go.com
  • SMTP USERNAME: jacob@mywebsite.com
  • SMTP PASSWORD: afdsafsfdsadfs

 

SMTP PORT: 587

  • AUTHENTICATION: LOGIN
  • USE TLS: CHECKED/TRUE
  • VERIFY MODE: none
  • SMTP FROM ADDRESS: jacob@mywebsite.com
  • SMTP DISPLAY NAME: Example Support Team

Testing SMTP

You can test your SMTP by using the Send Test Email button. Enter in an email, and if you get a successful message, you should be seeing an email.

 

Was this article helpful?
2 out of 4 found this helpful