How to Reset Password

Forgot Password

The Forgot Password feature enables users to reset their password through a secure email link. Follow the steps below based on your application’s SMTP setup.

Method 1: Resetting the Password (SMTP Configured)

If your application’s SMTP (Simple Mail Transfer Protocol) settings are configured, you can use the following steps to reset a password.

1. Access the Forgot Password Page

On the login screen, click on the “Forgot Password” link.

2. Request a Reset Link

Enter the registered email address linked to your account.

Submit the form to request a reset link.

3. Check Email and Reset Password

Open your email inbox. Locate the reset email and click on the provided link.

Enter a new password, confirm it, and submit.

4. Troubleshooting

If you don’t receive the reset email, check your spam or junk folder.

If the email is not found in spam, contact support for assistance.

Method 2: SMTP Not Configured (Example: Using Gmail)

To set up SMTP using Gmail, complete the following steps to activate the Forgot Password feature:

1. Open the .env File

Navigate to your project’s main directory and open the .env file.

1. Configure Gmail SMTP Settings

Gmail SMRP Supportive link: https://support.google.com/a/answer/176600?hl=en

Insert the following configuration, replacing placeholders with actual Gmail credentials:

MAIL_MAILER=smtp

MAIL_HOST=smtp.gmail.com

MAIL_PORT=587

MAIL_USERNAME=yourgmail@gmail.com

MAIL_PASSWORD=your-gmail-password

MAIL_ENCRYPTION=tls

MAIL_FROM_ADDRESS=yourgmail@gmail.com

MAIL_FROM_NAME=”YourAppName”

Explanation of Each Setting:

• MAIL_MAILER: Set to smtp for outgoing email functionality.
• MAIL_HOST: Use smtp.gmail.com for Gmail’s SMTP server.
• MAIL_PORT: Use port 587, Gmail’s designated port for SMTP.
• MAIL_USERNAME: Enter your Gmail address.
• MAIL_PASSWORD: Enter your Gmail password (or app-specific password if two-factor authentication is enabled).
• MAIL_ENCRYPTION: Use tls for Gmail.
• MAIL_FROM_ADDRESS: Enter your Gmail address.
• MAIL_FROM_NAME: Provide the name you want to appear on the email (e.g., your app’s name).

1. Save and Test SMTP Settings

Save the .env file.

Go to the “Forgot Password” page on your app, enter your email, and request a reset. Verify if the reset email is received.

1. Reset Password

Open the reset email, click the link, and follow the prompts to set a new password.

Troubleshooting Common Issues

• Email Not Received: Confirm the SMTP settings in the .env file and check the spam folder.
• Incorrect Credentials Error: Double-check MAIL_USERNAME and MAIL_PASSWORD.
• Connection Issue with Gmail: Ensure MAIL_HOST is set to smtp.gmail.com and MAIL_PORT is 587.