tuimail/MAIL_SERVER_SETUP.md

Mail Server Setup for Testing

Quick Start

1. Start the mail server:

   docker-compose up -d
   

2. Create a test user:

   docker exec -it mailserver setup email add test@example.com password123
   

3. Verify the server is running:

   docker-compose ps
   

IMAP Connection Details

• Host: localhost
• IMAP Port: 143 (unencrypted) or 993 (SSL/TLS)
• Username: test@example.com
• Password: password123

Useful Commands

# Stop the mail server
docker-compose down

# View logs
docker-compose logs -f mailserver

# List all email accounts
docker exec -it mailserver setup email list

# Add another user
docker exec -it mailserver setup email add user2@example.com pass456

# Delete a user
docker exec -it mailserver setup email del test@example.com

# Access the container shell
docker exec -it mailserver bash

Testing with telnet

You can test IMAP connectivity:

telnet localhost 143

Then try IMAP commands:

a1 LOGIN test@example.com password123
a2 LIST "" "*"
a3 SELECT INBOX
a4 LOGOUT

Send Test Email

# From within the container
docker exec -it mailserver bash
echo "Test email body" | mail -s "Test Subject" test@example.com

Or use SMTP (port 25/587) from your application.

Troubleshooting

• Check logs: docker-compose logs mailserver
• Ensure ports aren't already in use
• Data persists in ./docker-data/ directory