Configure email and SMTP

FastStaq sends transactional email (verification, password reset, magic links, ticket notifications) over SMTP. Email is queued and delivered by a background worker.

Set your SMTP credentials

In server/.env:

SMTP_HOST=smtp.yourprovider.com
SMTP_PORT=587
SMTP_USER=your-smtp-username
SMTP_PASS=your-smtp-password
FROM_EMAIL=noreply@yourdomain.com
FROM_NAME=Your Product

• Port 587 uses STARTTLS and works with most providers. Port 465 is implicit TLS.
• FROM_EMAIL should be an address on a domain you control and have authenticated.
• FROM_NAME is the display name recipients see.

Choose a provider

Any standard SMTP provider works (for example Postmark, Resend SMTP, Amazon SES, Mailgun, or SendGrid). For best deliverability, pick one that lets you authenticate your domain.

Improve deliverability

Set these DNS records on your sending domain so inboxes trust your mail:

• SPF authorizing your provider to send for the domain.
• DKIM keys provided by your email provider.
• DMARC policy to align SPF/DKIM.

Test delivery

1. Start the app and worker with pnpm dev.
2. Trigger an email, for example register a new user or use Forgot password on /login.
3. Confirm the message arrives. Email is processed by the background worker, so make sure the worker and Redis are running.

If nothing arrives, check the worker logs for SMTP errors and verify your credentials and port.

Related articles

• Authentication module
• Background jobs and observability

Still need help?

Open a support ticket and include the SMTP error from your logs.