Mailman in Docker

Originally, this image was based on https://github.com/adaline/dockermail and therefore forked and included. That's why the configuration is based on an own json-format.

Nevertheless, the container currently runs again https://github.com/tomav/docker-mailserver .

Configuration of the container

The configuration needs two aspects: One of the container itself plus the posfix-configuration. Furthermore, the postfix-process must have access to the mounted mailman-volume /mailman/var. An example docker-compose File is provided in the repository.

Postfix Configuration

The following config must be added to the postfix.cfg of a linked postfix-process.

By using https://github.com/tomav/docker-mailserver, the following lines must be added to the postfix-main.cf .

recipient_delimiter = +
unknown_local_recipient_reject_code = 550
owner_request_special = no
transport_maps = hash:/mailman/var/data/postfix_lmtp
local_recipient_maps = hash:/mailman/var/data/postfix_lmtp
relay_domains = hash:/mailman/var/data/postfix_domains

JSON-Config example

{
  "settings": {
    "myhostname": "mail.mydomain.com",
    "mailman": {
      "secret_key": "enter-a-random-secret-key-here",
      "language_code": "en-us",
      "time_zone": "America/Chicago",
      "admin_email": "[email protected]",
      "domains": ["lists.mydomain.com"]
    }
  }
}

The first domain is used as hostname. The secret key must contain only [A-Za-z0-9].

Language Code / Time Zone

supported language codes: http://www.i18nguy.com/unicode/language-identifiers.html

supported time zones: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Config changes

After config changes, mailman and the core container have to be restarted.

First run

The first run takes some minutes. Check docker logs to see the progress.

Create superuser

docker exec -it CONTAINER_ID /mailman/bin/mailman-web-django-admin createsuperuser

Footer / Welcome Templates

The default templates can be overriden by placing some text files in the templates directory.

• for the template search hierarchy see: https://gitlab.com/mailman/mailman/blob/master/src/mailman/utilities/i18n.py#L53
• for the template substitution placeholders see: https://gitlab.com/mailman/mailman/blob/cd61fcc88245af25bda231710cbbe1eb75a5e0e4/src/mailman/handlers/decorate.py#L234