Email
Configure an email provider of your choice to send and receive email notifications in Appsmith
Email is a widely used service to communicate with your users. You can set up email integration on your Appsmith instance to:
  • Invite users to your Appsmith workspace
  • Notify admins of important events & approval requests
Appsmith allows you to configure email using environment variables or the admin settings.

Configure using Environment Variables

Appsmith requires the following environment variables to be configured:
You could start with email configuration after following the Instance Configuration Guide for your instance deployment.
Variable
Description
APPSMITH_MAIL_ENABLED
Set it to true to enable the email service.
APPSMITH_MAIL_FROM
Set it to the verified email of the sender.
APPSMITH_REPLY_TO
Set it to the email that should receive replies by default.
APPSMITH_MAIL_HOST
Set it to the SMTP Host of the email service provider.
APPSMITH_MAIL_PORT
Set it to the SMTP Port available for the email service provider.
APPSMITH_MAIL_SMTP_TLS_ENABLED
Enables transport layer security if set to true.
APPSMITH_MAIL_SMTP_AUTH
Set it to true to share the credentials (APPSMITH_MAIL_USERNAME and APPSMITH_MAIL_PASSWORD) with the SMTP server.
APPSMITH_MAIL_USERNAME
Set it to the username for accessing the SMTP service provider.
APPSMITH_MAIL_PASSWORD
Set it to the password for the SMTP user. You can also set it to the API key generated by the email service provider for the SMTP user.
Be sure to double-check your config if you find that you're able to send test mail but not invites or password resets.
Restart the Appsmith instance once the environment variables are configured.

Configure using Admin Settings

You can configure the email for your self-hosted instance using the Admin Settings page. Follow the below steps:
  • Navigate to profile >> Admin Settings >> Select Email.
Add Configuration Details
  • Add configuration details provided by your email service provider.
    • SMTP Host - SMTP host of your email service provider
    • SMTP Port - SMTP port of your email service provider
    • From Address - a verified email address that will be shown in the from field when users receive an email
    • TLS Protected Connection - Bey default is enabled. Toggle back to disable
    • SMTP Username - Add the username for your email service provider
    • SMTP Password - Add the password for your email service provider
  • Click the SAVE & RESTART button to save the configurations and restart the Appsmith instance with the updated settings.
Once your instance is restarted, you can use the SEND TEST EMAIL button to send a test email. You should see a message at the top of the page telling you whether the test succeeded or failed. On success, you should also receive a test email in your email inbox.

Configuration Guides

Follow the below guides to configure popular email service providers:
Copy link
Edit on GitHub
On this page
Configure using Environment Variables
Configure using Admin Settings
Configuration Guides