Documentation
Complete guide to using DripEmails.org
SMTP Server
DripEmails includes a built-in SMTP server for handling email delivery.
Starting the SMTP Server
Development
# Basic (default port 1025)
python manage.py run_smtp_server
# Custom port
python manage.py run_smtp_server --port 2525
# With debug logging
python manage.py run_smtp_server --debug
# No authentication
python manage.py run_smtp_server --no-auth
Production
Use Supervisord or Systemd for process management. See Production Setup for details.
Configuration
Port Selection
- 1025: Default (recommended for development, avoids Postfix conflicts)
- 25: Standard SMTP port (requires root/admin, may conflict with Postfix)
- 2525: Alternative port (no conflicts)
Authentication
💡 Auto-Disable on Windows
On Windows with DEBUG=True, authentication is automatically disabled for easier development.
# Disable authentication (development)
python manage.py run_smtp_server --no-auth
# Enable authentication (production)
python manage.py run_smtp_server # auth enabled by default
Features
🚀 Async Performance
Built with aiosmtpd for high-performance email handling
🔐 Authentication
PLAIN and LOGIN authentication support
💾 Database Storage
Automatic email storage in database
📝 Logging
File-based logging for monitoring
Testing
# Test connection
telnet localhost 1025
# Test from Django shell
python manage.py shell
>>> from django.core.mail import send_mail
>>> send_mail('Test', 'Test message', 'from@example.com', ['to@example.com'])
Troubleshooting
See Deployment Troubleshooting for common SMTP server issues.