docker-mailserver

docker-mailserver is inspired by the renowned ISPMail guide.
This project lets you run your own email services, giving you independence from large providers. It is a secure, customizable, and feature-rich solution for managing your email infrastructure.

Container images are built on Alpine Linux or vendor base images and are kept lightweight.

📚 Documentation

Full documentation is available at: https://jeboehm.github.io/docker-mailserver/

The documentation includes:

Complete installation guides for Docker and Kubernetes
Configuration reference for all environment variables
Deployment examples and recipes
Architecture and development guides

Features

Secure email protocols: POP3, IMAP, and SMTP with user authentication
Web-based management interface for account, domain, and alias administration
Integrated webmail interface
DKIM message signing and spam filtering with Rspamd
Real-time spam prevention using RBLs (Real-Time Blackhole Lists)
Fetchmail integration for external mail retrieval
Quota management, catch-all addresses, and send-only accounts
Restriction of sender addresses for enhanced security
Full-text search and enforced TLS
DNS Validation Wizard for all mail related DNS records
Generates configuration profiles for iOS and macOS devices
Supports assisted client configuration in Outlook and Thunderbird
Continuous health monitoring

See the documentation for a complete feature list.

Quick start

bash
# 1. Clone the repository or download a release
git clone https://github.com/jeboehm/docker-mailserver.git
cd docker-mailserver

# 2. Copy and edit the environment file (set passwords for MYSQL_PASSWORD,
#    REDIS_PASSWORD, CONTROLLER_PASSWORD, and DOVEADM_API_KEY)
cp .env.dist .env

# 3. Pull images and start services
bin/production.sh pull
bin/production.sh up -d --wait

# 4. Create the first email account and admin user
bin/production.sh run --rm web setup.sh