Skip to main content

​
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.
The easiest way to configure email is through the Admin Panel:
  1. Log in as an administrator (the first registered user)
  2. Go to Admin Panel → Settings
  3. Find the Email Configuration section
  4. Click the + or ✏️ button to configure
The Admin Panel configuration supports live testing — you can verify your SMTP settings work before saving.

​
Configuration Fields

FieldDescriptionExample
SMTP HostSMTP server addresssmtp.gmail.com
PortSMTP port465 (SSL) or 587 (TLS)
SecureUse SSL/TLStrue
Sender EmailFrom address[email protected]
Sender NameDisplay nameTeable Notification
UsernameSMTP authentication user[email protected]
PasswordSMTP password or app passwordxxxxxxxxxxxxxx

​
Option 2: Environment Variables

For deployments where you prefer file-based configuration, use environment variables: 
BACKEND_MAIL_HOST=smtp.example.com
BACKEND_MAIL_PORT=465
BACKEND_MAIL_SECURE=true
BACKEND_MAIL_SENDER=[email protected]
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

# 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=[email protected]  # 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

# 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=[email protected]
BACKEND_MAIL_SENDER_NAME=Teable Notification
BACKEND_MAIL_AUTH_USER=[email protected]
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # 16-digit app password

# 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=[email protected]
BACKEND_MAIL_SENDER_NAME=Teable Notification
BACKEND_MAIL_AUTH_USER=[email protected]
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # Your Microsoft 365 password or app password

# 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=[email protected]
BACKEND_MAIL_SENDER_NAME=Teable Notification
BACKEND_MAIL_AUTH_USER=apikey
BACKEND_MAIL_AUTH_PASS=xxxxxxxxxxxxxx  # Your SendGrid API Key
Last modified on January 23, 2026