Skip to content

feat(email): add SMTP support for self-hosted platform emails #3696

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
xid-ryan wants to merge 10 commits into
base: main
Choose a base branch
from
Open

feat(email): add SMTP support for self-hosted platform emails #3696

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
f907d40
feat: add ANTHROPIC_BASE_URL and USE_SERVER_KEYS support
wickedev Feb 8, 2026
98ae184
fix: use npx instead of bun for build step to avoid QEMU segfault
wickedev Feb 8, 2026
196c32d
ci: add GitHub Actions workflow for ECR build, revert QEMU workaround
wickedev Feb 8, 2026
53e0399
fix: skip null env values in deployment template to allow envFrom ove…
wickedev Feb 8, 2026
5b6a056
fix: scope USE_SERVER_KEYS to Anthropic Claude models only
wickedev Feb 9, 2026
715025a
feat(email): add SMTP app delivery backend
wickedev Mar 21, 2026
304d0f6
chore(email): add SMTP runtime environment vars
wickedev Mar 21, 2026
94f94b3
docs(self-hosting): document SMTP email configuration
wickedev Mar 21, 2026
1911264
feat(helm): expose SMTP chart values
wickedev Mar 21, 2026
965ae39
fix(helm): keep SMTP credentials in app secrets
wickedev Mar 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
chore(email): add SMTP runtime environment vars 
Expose SMTP configuration through the app env surface so self-hosted operators can wire a custom mail server without patching code.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
  • Loading branch information
@wickedev @sisyphus-dev-ai
wickedev and sisyphus-dev-ai committed Mar 21, 2026
commit 304d0f683117c91c2e5d06b67569ca8efbdff865
10 changes: 10 additions & 0 deletions apps/sim/.env.example
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,16 @@ API_ENCRYPTION_KEY=your_api_encryption_key # Use `openssl rand -hex 32` to gener
# Email Provider (Optional)
# RESEND_API_KEY= # Uncomment and add your key from https://resend.com to send actual emails
# If left commented out, emails will be logged to console instead
# FROM_EMAIL_ADDRESS="Sim <noreply@example.com>"
# EMAIL_DOMAIN=example.com

# SMTP (Optional - alternative to Resend/Azure for self-hosting)
# If multiple providers are configured, Sim tries Resend first, then Azure, then SMTP.
# SMTP_HOST=smtp.example.com
# SMTP_PORT=587
# SMTP_SECURE=TLS # TLS (STARTTLS), SSL (implicit TLS, usually 465), or None
# SMTP_USERNAME=your_smtp_username
# SMTP_PASSWORD=your_smtp_password

# Local AI Models (Optional)
# OLLAMA_URL=http://localhost:11434 # URL for local Ollama server - uncomment if using local models
Expand Down
5 changes: 5 additions & 0 deletions apps/sim/lib/core/config/env.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,11 @@ export const env = createEnv({
PERSONAL_EMAIL_FROM: z.string().min(1).optional(), // From address for personalized emails
EMAIL_DOMAIN: z.string().min(1).optional(), // Domain for sending emails (fallback when FROM_EMAIL_ADDRESS not set)
AZURE_ACS_CONNECTION_STRING: z.string().optional(), // Azure Communication Services connection string
SMTP_HOST: z.string().min(1).optional(), // SMTP server hostname for self-hosted email delivery
SMTP_PORT: z.string().regex(/^\d+$/).optional(), // SMTP server port (e.g. 587, 465)
SMTP_SECURE: z.enum(['TLS', 'SSL', 'None']).optional(), // SMTP security mode (STARTTLS, implicit TLS, or plain)
SMTP_USERNAME: z.string().min(1).optional(), // SMTP username for authenticated relays
SMTP_PASSWORD: z.string().min(1).optional(), // SMTP password for authenticated relays

// SMS & Messaging
TWILIO_ACCOUNT_SID: z.string().min(1).optional(), // Twilio Account SID for SMS sending
Expand Down