Saltar al contenido principal

Email Delivery Problems

Troubleshoot email sending failures.

Emails Not Sendingโ€‹

Check SMTP configuration:

MAIL_FROM_ADDRESS=noreply@example.com
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=your-username
MAIL_PASSWORD=your-password

Connection Timeoutโ€‹

Symptom: ECONNREFUSED or ETIMEDOUT

Fixes:

  1. Verify SMTP host and port
  2. Check firewall rules allow outbound port 587/465
  3. Try port 465 (SSL) vs 587 (TLS)

Authentication Failedโ€‹

Fixes:

  1. Check username/password
  2. For Gmail: enable "Less secure app access" or use App Passwords
  3. For Office 365: use OAuth2 app registration

Custom SMTP Per Organizationโ€‹

Organizations can configure separate SMTP via Settings โ†’ Custom SMTP. See Custom SMTP.

Testing Emailโ€‹

Use a test service like Mailtrap during development:

MAIL_HOST=sandbox.smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=your-mailtrap-user
MAIL_PASSWORD=your-mailtrap-pass