tests/EMAIL_CONFIGURATION.md

Email Configuration Guide for AIMHSA

Current Status

The email service is not configured, which is why you're seeing the error:

ERROR in app: Failed to send email: Email service not configured

How to Configure Email Service

Option 1: Gmail (Recommended)

1. Create a .env file in your project root directory
2. Add the following configuration:

# Gmail SMTP Configuration
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=your-email@gmail.com
SMTP_PASSWORD=your-app-password
FROM_EMAIL=noreply@aimhsa.rw

3. Get Gmail App Password:
   • Go to your Google Account settings
   • Enable 2-Factor Authentication
   • Generate an "App Password" for this application
   • Use the 16-character app password (not your regular password)

Option 2: Outlook/Hotmail

SMTP_SERVER=smtp-mail.outlook.com
SMTP_PORT=587
SMTP_USERNAME=your-email@outlook.com
SMTP_PASSWORD=your-password
FROM_EMAIL=noreply@aimhsa.rw

Option 3: Yahoo Mail

SMTP_SERVER=smtp.mail.yahoo.com
SMTP_PORT=587
SMTP_USERNAME=your-email@yahoo.com
SMTP_PASSWORD=your-app-password
FROM_EMAIL=noreply@aimhsa.rw

Option 4: Custom SMTP Server

SMTP_SERVER=your-smtp-server.com
SMTP_PORT=587
SMTP_USERNAME=your-username
SMTP_PASSWORD=your-password
FROM_EMAIL=noreply@aimhsa.rw

Testing Email Configuration

After creating the .env file:

1. Restart your Flask application
2. Test the forgot password functionality
3. Check the logs for email sending status

Current Behavior (Without Email Configuration)

• ✅ Forgot password still works - returns reset token in response
• ✅ Password reset functionality works - you can use the token manually
• ❌ No actual emails sent - token is displayed in the UI for testing

Security Notes

• Never commit .env files to version control
• Use app passwords instead of regular passwords for Gmail
• Keep email credentials secure
• Consider using environment variables in production

Troubleshooting

Common Issues:

1. "Authentication failed" - Check username/password
2. "Connection refused" - Check SMTP server and port
3. "App password required" - Enable 2FA and generate app password
4. "Less secure app access" - Use app passwords instead

Test Email Configuration:

# Test with curl
curl -X POST https://prodevroger-ishingiro.hf.space/forgot_password \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'