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.
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
- 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)
- Spam training by moving messages into and out of the Junk folder
- Fetchmail integration for external mail retrieval
- Quota management with notifications, catch-all addresses, and send-only accounts
- Local address extension (RFC 5233) for per-address sub-addressing
- 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.
# 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 DB_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.shAfter setup, access the management interface at
http://127.0.0.1:81/ and webmail at http://127.0.0.1:81/webmail/.
For a complete walkthrough, see the Getting Started tutorial.
docker-mailserver can be set up using Docker or Kubernetes.
For detailed installation instructions, see How to install with Docker Compose or How to install on Kubernetes.
- Documentation - Complete documentation and guides
- Development guide - Build, test, and contribute
- Issues - Report bugs and request features
- Releases - Release notes and changelog
- License - MIT
- Container Images: