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:
| Volume | What | Lost means |
|---|---|---|
pgdata | users, mailboxes, messages | the mail |
data | attachments, the DKIM key, generated passwords | attachments; a new DKIM key and DNS record |
secrets | database password, key of login sessions | everyone logs in again |
lego, tls | the certificate | nothing: 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
- Another user's password: Admin panel → USERS → new password.
- The first administrator's password, never changed:
docker compose exec mail cat /app/data/initial-passwords.txt.
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:
- Take the template:
https://mail.example.com/api/i18n/en. - Translate the values. Keep the keys and the
{placeholders}; set@nameto the language's own name. - Save it as
/app/data/i18n/<code>.jsonin thedatavolume, for examplede.jsonorpt-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/.