SMTP Configuration

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/QROkes/webinoly/llms.txt

Use this file to discover all available pages before exploring further.

​

Prerequisites

• Postfix mail server (installed with PHP stack)
• SMTP service credentials (Gmail, SendGrid, Mailgun, etc.)
• A valid domain name configured on your server

​

Install Postfix

sudo stack -php

sudo stack -postfix

​

Configure SMTP

​

Interactive Setup

sudo webinoly -smtp

1. SMTP Host: Your email provider’s SMTP server (e.g., smtp.gmail.com)
2. User: SMTP username or email address
3. Password: SMTP password or app-specific password
4. Main Hostname/Domain: Your primary domain for sending emails

​

Non-Interactive Setup

sudo webinoly -smtp=[smtp.example.com,user@example.com,password,example.com]

​

SMTP Provider Examples

​

Gmail

1. Enable 2-factor authentication on your Google account
2. Generate an app-specific password: https://myaccount.google.com/apppasswords
3. Configure Webinoly:

sudo webinoly -smtp=[smtp.gmail.com,your-email@gmail.com,app-password,yourdomain.com]

​

SendGrid

1. Create a SendGrid account and API key
2. Configure:

sudo webinoly -smtp=[smtp.sendgrid.net,apikey,your-api-key,yourdomain.com]

​

Mailgun

1. Create Mailgun account and obtain SMTP credentials
2. Configure:

sudo webinoly -smtp=[smtp.mailgun.org,postmaster@your-domain.mailgun.org,smtp-password,yourdomain.com]

​

Amazon SES

1. Create SMTP credentials in AWS SES console
2. Configure:

sudo webinoly -smtp=[email-smtp.us-east-1.amazonaws.com,AWS-ACCESS-KEY,AWS-SECRET-KEY,yourdomain.com]

​

Postmark

sudo webinoly -smtp=[smtp.postmarkapp.com,your-server-token,your-server-token,yourdomain.com]

​

Brevo (Sendinblue)

sudo webinoly -smtp=[smtp-relay.brevo.com,your-email@example.com,smtp-key,yourdomain.com]

​

Configuration Files

myhostname = yourdomain.com
myorigin = /etc/mailname
relayhost = smtp.example.com:587

smtp.example.com:587 user@example.com:password

yourdomain.com

​

Main Hostname

• The FROM domain for system emails
• Server’s mail identity
• Default origin for outgoing mail

• Must be a valid domain configured on your server
• Should match a site in /etc/nginx/sites-available/
• Recommended: Configure SPF and DKIM records for this domain

​

Test Email Delivery

# Send test email
echo "Test email from Webinoly" | mail -s "Test Subject" recipient@example.com

# Check mail queue
mailq

# View mail log
sudo log -mail

​

Monitor Email Logs

# Real-time mail logs
sudo log -mail

# Or
sudo log -email

# Check for errors
sudo tail -f /var/log/mail.err

• status=sent - Email sent successfully
• status=deferred - Temporary failure, will retry
• status=bounced - Permanent failure

​

WordPress Integration

​

Configure wp-mail-smtp Plugin

1. Install WP Mail SMTP plugin
2. Configure with “Other SMTP” option:
   • SMTP Host: localhost
   • SMTP Port: 25
   • Encryption: None
   • Authentication: Off

​

Alternative: Direct SMTP in WordPress

1. Install WP Mail SMTP plugin
2. Enter your SMTP provider credentials
3. This bypasses Postfix (not recommended - use Webinoly SMTP instead)

​

Troubleshooting

​

Emails Not Sending

1. Check Postfix status:
   sudo systemctl status postfix
   
2. Test SMTP credentials:
   # Test authentication
   sudo postfix check
   sudo postfix reload
   
3. Verify SMTP host is reachable:
   telnet smtp.example.com 587
   
4. Check mail queue:
   mailq
   
5. View detailed logs:
   sudo tail -100 /var/log/mail.log
   

​

Authentication Failures

1. Verify credentials are correct
2. Check if app-specific password is needed (Gmail)
3. Ensure SMTP user has sending permissions
4. Regenerate SMTP password/API key

​

DNS/SPF Issues

1. Add SPF record to main hostname domain:
   v=spf1 include:_spf.google.com ~all
   
   (Adjust based on SMTP provider)
2. Configure DKIM if supported by provider
3. Set up DMARC policy:
   v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com
   

​

Firewall Blocking Port 587

# Check if port 587 is blocked
sudo ufw status

# Allow outgoing SMTP
sudo ufw allow out 587/tcp

​

Queue Not Processing

# Force queue processing
sudo postqueue -f

# Remove specific messages
sudo postsuper -d MESSAGE_ID

# Remove all queued messages
sudo postsuper -d ALL

​

Backup SMTP Configuration

sudo webinoly -backup=export -server

sudo cp /etc/postfix/main.cf /root/main.cf.backup
sudo cp /etc/postfix/sasl_passwd /root/sasl_passwd.backup
sudo cp /etc/mailname /root/mailname.backup

​

Disable SMTP

# Restore from template
sudo cp /opt/webinoly/templates/source/main.cf /etc/postfix/main.cf

# Remove credentials
sudo rm /etc/postfix/sasl_passwd*

# Restart Postfix
sudo systemctl restart postfix

​

Security Best Practices

1. Use App-Specific Passwords: Don’t use main account passwords
2. Rotate Credentials: Change SMTP passwords regularly
3. Monitor Logs: Watch for unauthorized sending attempts
4. Rate Limiting: Most providers limit sending rates
5. SPF/DKIM/DMARC: Configure email authentication
6. Restrict Access: Keep sasl_passwd file secure (already 0600)

​

Advanced Configuration

​

Custom Postfix Settings

sudo nano /etc/postfix/main.cf

# Set message size limit (50MB)
message_size_limit = 52428800

# Set mailbox size limit
mailbox_size_limit = 0

# Set sender address
smtp_generic_maps = hash:/etc/postfix/generic

sudo systemctl reload postfix

​

Multiple SMTP Relays

# Edit sender-dependent relay map
sudo nano /etc/postfix/sender_relay

user1@domain1.com    [smtp.provider1.com]:587
user2@domain2.com    [smtp.provider2.com]:587

sender_dependent_relayhost_maps = hash:/etc/postfix/sender_relay

sudo postmap /etc/postfix/sender_relay
sudo systemctl reload postfix