libriciel/mailmaster repository overview

⁠Docker Mailserver

This project is a fork of : https://www.github.com/invokr/docker-mail⁠

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.

⁠Running the container

docker pull invokr/mail
docker run -name mail -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 mail.

We are using dumb-init⁠ to start supervisord so that all of the daemons shut down gracefully.

⁠Configuration

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 [email protected]

# Add a new alias
docker exec mail /opt/bin/newalias [email protected] [email protected]

# 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 [email protected]

⁠Logs

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

⁠Backups

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.

⁠License

Public Domain or MIT, whatever is available in your country

⁠Libriciel add

• DOMAINS=liste (séparée par des espaces) des domaines pour lesquels vous souhaitez créer des boites mails
• MAILS=liste (séparée par des espaces) des adresses mails que vous souhaitez créer
• NOPASS=true si définit les comptes utilisateurs auront pour mot de passe le début de l'adresse mail (exemple : utilisateur [email protected]⁠ => password : user)

Avec ces trois variables, vous créez directement les adresses mails et les utilisateurs dès le lancement du service.

⁠Exemple docker-compose.yml:

version: '3.7'

services:
  mailserver:
    networks:
      - backends
    image: mailmaster:2.1.0
    hostname: mail.libriciel.io
    environment:
      POSTFIX_HOSTNAME: "mail.libriciel.io"
      DOMAINS: "libriciel.io mylibriciel.net"
      MAILS: "[email protected] [email protected] [email protected] [email protected]"
      NOPASS: "true"

  mycontainer:
    networks:
      - backends
    image: ubuntu:18.04
    environment:
      SMTP_SERVER: mailserver
    command: sleep 36000

networks:
  backends:

Dans mycontainer vous pouvez installer les paquets msmtp msmtp-mta vim mailutils pour tester l'envoi d'un mail en ligne de commande. Vous trouverez sur le projet git un exemple de configuration du fichier /etc/msmtprc.

Le projet est visible sur le Gitlab de l'ADULLACT : https://gitlab.adullact.net/Libriciel/mail-master⁠