Skip to content

Email Authentication

Email authentication is disabled by default. When enabled, users can register with an email address and password, verify their address via a link, and reset their password through email.

Terminal window
EMAIL_AUTH_ENABLED=true

You must also configure at least one email delivery method (SMTP or an email API provider) for verification and password reset emails to be sent.

Configure a standard SMTP server:

Terminal window
SMTP_HOST=smtp.example.com
SMTP_PORT=587 # default: 587
SMTP_USER=user@example.com
SMTP_PASS=your-password
SMTP_FROM=noreply@example.com

SMTP_PORT defaults to 587. Most providers use port 587 with STARTTLS or port 465 with TLS.

  • Registration: Users can create an account with name, email, and password (minimum 8 characters).
  • Email verification: A verification link is sent on registration. Users cannot log in until their email is verified.
  • Password reset: A reset link is sent to the user’s email address, valid for one hour.