Public | Automated Build

Last pushed: 2 months ago
Short Description
Dovecot and Postfix
Full Description

Docker Mailserver

This container aims to provide a secure and portable mail environment based on Postfix and Dovecot.

SSL is enabled per default and new TLS keys are generated when starting the container,
these should be replaced with your own keys if possible.
Dovecot is only listening via SSL on port 993. Postfix is configured to use
opportunistic encryption as to not bounce mails from non-tls clients.
In addition to common spam lists, opendmarc is used to authenticate messages when
available. Mozillas public suffix list is updated once per week via cron.

This is not a prime example of how you should build a docker container, but I'm to lazy to pull all the configurations
apart so that each service is running in it's own container.

CentOS is used as the base image instead of alpine so I can be sure postfix / dovecot stay on their respective versions.

Running the container

docker pull invokr/mail
docker run -d -p 25:25 -p 587:587 -p 993:993 -v secure:/secure -v vmail:/vmail -e POSTFIX_HOSTNAME=mail.domain.tld invokr/mail

Make sure POSTFIX_HOSTNAME is a subdomain or else you won't be able to receive mail on that domain.

Stopping the container

The container can be safely stopped with docker stop <id>.

dumb-init is used to start supervisord
so that all of the daemons shut down gracefully without corrupting your files.


The configuration for the different services is kept in the config folder.
The following scripts are provided to quickly get your server up and running:

# Create a new imap user, will ask for a password
docker exec -it mail /opt/bin/useradd you@yourdomain.tld

# Add a new alias
docker exec mail /opt/bin/newalias you@yourdomain.tld alias@somedomain.tld

# Accept mail for a new hostname
docker exec mail /opt/bin/newdomain newdomain.tld

# Remove a user (will ask for your confirmation)
docker exec -it mail /opt/bin/userdel you@yourdomain.tld


All mail logs are written to /secure/maillog per default.


All the data is saved in /secure (User configuration and SSL certificates) and
/vmail (Mailboxes). Backing up these directories is enough to transfer your mail
server to a new host or recover your data in the case of a hard drive failure.


Public Domain or MIT, whatever is available in your country

Docker Pull Command
Source Repository