A step-by-step guide to set up email delivery in your X Dairy Automate System

---

STEP 1: ACCESS SMTP SETTINGS #

1. Log in to your admin panel
2. Go to Configuration → SMTP Settings
3. Or open: /smtp-settings

---

STEP 2: CHOOSE YOUR EMAIL PROVIDER #

If you use Gmail, Yahoo, Outlook → select SMTP
If you use a Linux server with Sendmail → select Sendmail
If you use Mailgun → select Mailgun
If you use Amazon SES → select Amazon SES
If you use Postmark → select Postmark

---

STEP 3: ENTER SERVER DETAILS #

GMAIL
SMTP Host: smtp.gmail.com
SMTP Port: 587
Encryption: TLS
Username: your-email@gmail.com
Password: App Password

How to get Gmail App Password:

1. Open Google Account Security
2. Enable 2-Step Verification
3. Open “App passwords”
4. Choose Mail
5. Copy the generated password

OUTLOOK / OFFICE 365
SMTP Host: smtp.office365.com
SMTP Port: 587
Encryption: TLS
Username: your-email@outlook.com
Password: Your password

YAHOO
SMTP Host: smtp.mail.yahoo.com
SMTP Port: 587
Encryption: TLS
Username: your-email@yahoo.com
Password: App Password

SENDGRID
SMTP Host: smtp.sendgrid.net
SMTP Port: 587
Encryption: TLS
Username: apikey
Password: Your SendGrid API Key

MAILGUN
SMTP Host: smtp.mailgun.org
SMTP Port: 587
Encryption: TLS
Username: postmaster@your-domain.mailgun.org
Password: Mailgun SMTP password

---

STEP 4: CONFIGURE SENDER INFORMATION #

From Email: the email that sends messages
Example: noreply@yourdairy.com

From Name: the name users see
Example: X Dairy System

---

STEP 5: ENABLE THE CONFIGURATION #

1. Check “Enable Email Sending”
2. Click Save

Note: If disabled, the system uses .env settings.

---

STEP 6: TEST YOUR CONFIGURATION #

1. Open the Test Connection panel
2. Enter a test email
3. Click Send Test Email
4. Check inbox and spam

You should receive:
“SMTP Test – X Dairy Automate Dairy Management System”

---

TROUBLESHOOTING #

CONNECTION TIMEOUT

• Check hostname
• Check port (587 TLS / 465 SSL)
• Check firewall

AUTHENTICATION FAILED

• Verify username/password
• Use App Password for Gmail/Yahoo
• Check if account is locked

SSL CERTIFICATE ERROR

• Switch from SSL to TLS
• Use port 587

EMAIL NOT RECEIVED

• Check spam
• Verify From Email is valid
• Check logs: storage/logs/laravel.log

---

QUICK REFERENCE #

Ports:
TLS → 587
SSL → 465
None → 25

Status:
Active → Using database settings
Inactive → Using .env
Success → Last test worked
Failed → Last test failed

---

SECURITY NOTES #

Passwords are encrypted
Settings require admin login
Forms use CSRF protection

---

NEED HELP?
Check Laravel logs or contact CodeX Link Support.