Setting Up Email/SMTP for Forgot Password & Notifications

Last updated: 16 February 2025 · 2 min read

BillBook uses SMTP email settings for sending notifications, including Forgot Password emails, Offline Payment Approvals, and other system alerts.

Steps to Configure SMTP in BillBook

  1. Open the .env file in your hosting/server file manager.
  2. Locate the mail configurations:
MAIL_DRIVER=smtp
MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_ENCRYPTION=
  1. Enter the correct SMTP details.
  2. Save the changes.

Example SMTP Configuration for Gmail:

MAIL_DRIVER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=your-email-password
MAIL_ENCRYPTION=TLS

Important Notes:

  • Use either TLS or SSL, not both.
  • TLS → Port 587 | SSL → Port 465

Gmail SMTP Setup & Troubleshooting

If you're using Gmail with 2-Factor Authentication:

  • Generate an App Password for BillBook.
  • Go to Google App Passwords → Select "Other (Custom App)" → Generate a password.
  • Use this generated password in MAIL_PASSWORD.