Configure Email Service

Configuration Methods

Teable supports two ways to configure email service:

Admin Panel (Recommended)

Visual configuration with live testing. No restart required.

Environment Variables

Traditional configuration via .env file. Requires container restart.

Option 1: Admin Panel (Recommended)

The easiest way to configure email is through the Admin Panel:

Log in as an administrator (the first registered user)
Go to Admin Panel → Instance settings
Find the Email section
Configure Notify email and Automation email as needed

The Admin Panel configuration supports live testing — you can verify your SMTP settings work before saving.

Notify email: Used for user verification, password reset, invitations, system notifications, and similar emails.
Automation email: Used as the default mail service for automation Send Email actions. A single Send Email action can also configure its own custom SMTP server.

Configuration sources and priority

We recommend configuring mail service in Admin Panel → Instance settings → Email first. The effective priority is:

Custom mail server inside the Send Email action: Applies only to that specific Send Email action in the current automation.
Admin Panel → Instance settings → Email → Automation email: Used by automation emails when the Send Email action does not configure its own mail server.
Admin Panel → Instance settings → Email → Notify email: Used for user verification, password reset, invitations, system notifications, and similar emails. It is also used as the fallback for automation emails if Automation email is not configured.
BACKEND_MAIL_* environment variables: Deployment-level default mail configuration. Used only as a fallback when the corresponding mailbox is not configured in the Admin Panel.

Configuration Fields

Field	Description	Example
Server address	SMTP server address	`smtp.gmail.com`
Port	SMTP port	`465` (SSL) or `587` (TLS)
SSL/TLS	Whether to use SSL/TLS	`true`
Username	SMTP authentication user	`noreply@company.com`
Password	SMTP password or app password	`xxxxxxxxxxxxxx`
Sender address	From address	`noreply@company.com`
Sender name	Display name	`Teable Notification`

Option 2: Environment Variables

For deployments where you prefer file-based configuration, use environment variables:

We recommend configuring Notify email and Automation email in Admin Panel → Instance settings → Email first. Environment variables are mainly used as deployment-level defaults and fallback configuration.

BACKEND_MAIL_HOST=smtp.example.com
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=noreply@company.com
BACKEND_MAIL_SENDER_NAME=Teable
BACKEND_MAIL_AUTH_USER=username
BACKEND_MAIL_AUTH_PASS=your_password

After changing environment variables, you must restart the Teable container for changes to take effect.

SMTP Provider Examples

AWS SES

# How to obtain: AWS Console → Simple Email Service → SMTP Settings → Create SMTP Credentials
BACKEND_MAIL_HOST=email-smtp.us-east-1.amazonaws.com  # Replace with your region
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=noreply@yourdomain.com  # Must be a verified sender address
BACKEND_MAIL_SENDER_NAME=Teable Notification
BACKEND_MAIL_AUTH_USER=your_smtp_username   # AWS SMTP username
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx       # AWS SMTP password

Gmail

# How to obtain: Google Account → Security → 2-Step Verification → App Passwords
BACKEND_MAIL_HOST=smtp.gmail.com
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=you@gmail.com
BACKEND_MAIL_SENDER_NAME=Teable Notification
BACKEND_MAIL_AUTH_USER=you@gmail.com
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # 16-digit app password

Microsoft 365 / Outlook

# How to obtain: Microsoft 365 admin center → Security → Policies & rules → Email authentication
BACKEND_MAIL_HOST=smtp.office365.com
BACKEND_MAIL_PORT=587
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=your.name@yourdomain.com
BACKEND_MAIL_SENDER_NAME=Teable Notification
BACKEND_MAIL_AUTH_USER=your.name@yourdomain.com
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # Your Microsoft 365 password or app password

SendGrid

# How to obtain: SendGrid Dashboard → Settings → API Keys → Create API Key
BACKEND_MAIL_HOST=smtp.sendgrid.net
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=noreply@yourdomain.com
BACKEND_MAIL_SENDER_NAME=Teable Notification
BACKEND_MAIL_AUTH_USER=apikey
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # Your SendGrid API Key

Self-Hosted License

Quick Start

Admin Panel

Configuration

Compliance & Telemetry

Maintenance

Deprecated

Configure Email Service

Configuration Methods

Admin Panel (Recommended)

Environment Variables

Option 1: Admin Panel (Recommended)

Configuration sources and priority

Configuration Fields

Option 2: Environment Variables

SMTP Provider Examples

​Configuration Methods

Admin Panel (Recommended)

Environment Variables

​Option 1: Admin Panel (Recommended)

​Configuration sources and priority

​Configuration Fields

​Option 2: Environment Variables

​SMTP Provider Examples

​Related Documentation

Configuration Methods

Option 1: Admin Panel (Recommended)

Configuration sources and priority

Configuration Fields

Option 2: Environment Variables

SMTP Provider Examples

Related Documentation