Configuration

Email Setup

Configure SMTP to enable transactional emails like password resets and notifications

Overview

Trackr uses SMTP to send transactional emails such as password resets, invitations, and notifications. Add the following variables to your .env file to enable email delivery.

Environment Variables

SMTP_ADMIN_EMAIL=admin@example.com
SMTP_HOST=smtp.example.com
SMTP_PORT=465
SMTP_USER=your-smtp-username
SMTP_PASS=your-smtp-password
SMTP_SENDER_NAME=Your Name <noreply@example.com>
VariableDescription
SMTP_ADMIN_EMAILAdmin email address used for system notifications
SMTP_HOSTHostname of your SMTP server
SMTP_PORTSMTP port — use 465 for SSL or 587 for TLS
SMTP_USERUsername for SMTP authentication
SMTP_PASSPassword for SMTP authentication
SMTP_SENDER_NAMEDisplay name and address shown in the “From” field

Setup Steps

  1. Open your .env file in the project root
  2. Add the SMTP variables listed above
  3. Replace all placeholder values with your actual SMTP credentials
  4. Restart the application for changes to take effect
docker compose down && docker compose up -d

Verify

After restarting, trigger a password reset from the login screen. If the email arrives, your SMTP configuration is working correctly.

Troubleshooting

  • Emails not sending — Double-check SMTP_HOST, SMTP_PORT, and credentials. Ensure your SMTP provider allows connections from your server’s IP.
  • Connection timeout — Verify that port 465 (or 587) is not blocked by your firewall or hosting provider.
  • Emails landing in spam — Set up SPF, DKIM, and DMARC DNS records for your sending domain.
ende