SYNTH MAIL

Operations

Update

docker compose pull
docker compose up -d

The database is updated on start. What changed: Changelog. Take a backup before a new minor version (0.2 → 0.3).

To stay on one version, pin it in .env: MAIL_IMAGE_TAG=0.2.1.

Roll back

Set the previous version in .env (MAIL_IMAGE_TAG=0.2.0) and run docker compose up -d. Database changes are only added, never removed, so an older image starts on a newer database.

The image moved from liosha/synth-mail to jambotron/synth-mail in 0.2.1 — older versions are no longer published; keep a backup to go back before 0.2.1.

Backup

Everything is in Docker volumes:

VolumeWhatLost means
pgdatausers, mailboxes, messagesthe mail
dataattachments, the DKIM key, generated passwordsattachments; a new DKIM key and DNS record
secretsdatabase password, key of login sessionseveryone logs in again
lego, tlsthe certificatenothing: issued again

A consistent copy: docker compose stop, copy the volumes, docker compose start. Without stopping: dump the database and copy data:

docker compose exec db pg_dump -U mail mailserver | gzip > mail-$(date +%F).sql.gz
docker run --rm -v synth-mail_data:/data -v "$PWD":/out alpine tar czf /out/data-$(date +%F).tgz -C /data .

Forgot a password

Languages

English, Russian and Ukrainian are built in; each user picks one in the account menu. MAIL_DEFAULT_LANGUAGE sets the language until a person picks one.

To add a language:

  1. Take the template: https://mail.example.com/api/i18n/en.
  2. Translate the values. Keep the keys and the {placeholders}; set @name to the language's own name.
  3. Save it as /app/data/i18n/<code>.json in the data volume, for example de.json or pt-BR.json.

No restart: the language appears in the menu at once. Texts missing from the file stay in English.

Logs

docker compose logs -f mail

Every incoming message is logged with its SPF, DKIM and DMARC verdict; outgoing ones with the delivery result.

License

The image is free to download, install and run for any purpose, including commercial use, on any number of servers. It may be redistributed only unmodified, free of charge and with the license. The full text is in the image: /app/licenses/LICENSE. Third-party components keep their own licenses: /app/licenses/.