Email Not Processing¶

Troubleshooting guide for emails stuck in queue or not being filtered.

Quick Checks¶

# Check mail queue
sudo mailq

# Check services
sudo mb-status

# Check logs
sudo tail -n 50 /var/log/mail.log
sudo tail -n 50 /var/log/mailborder/mb-filter.log

Common Causes¶

Queue Stuck¶

Symptoms: Emails in queue not moving

Check queue:

sudo mailq

Flush queue:

sudo postfix flush

If still stuck:

# Restart filtering
sudo systemctl restart mb-filter
sudo postfix flush

Filter Not Working¶

Test filter:

sudo netstat -tulpn | grep 10031
# Should show mb-filter listening

Restart filter:

sudo systemctl restart mb-filter

Check Postfix integration:

sudo postconf | grep content_filter
# Should show: content_filter = mb-filter:[127.0.0.1]:10031

Disk Full¶

Check space:

df -h

Clean up:

sudo mb-maintenance --cleanup-logs
sudo mb-quarantine-cleanup

Database Issues¶

Test connection:

sudo mysql -u mailborder -p mailborder -e "SELECT 1"

Check connections:

sudo mysql -u mailborder -p -e "SHOW PROCESSLIST"