Synth Mail
A complete mail server in one Docker image: SMTP, IMAP and a web client with a synthwave look.
Your domain, your server. DKIM, SPF and DMARC included. Free for any use.
docker pull liosha/synth-mail
Everything a mail server needs
Receives mail for your domain and sends it straight to the recipients' servers, signed with DKIM. Checks incoming mail and keeps password guessers out.
SMTP, IMAP, web mail
One image, one database. Thunderbird and phone mail work over SMTP and IMAP with app passwords.
DKIM, SPF, DMARC
Outgoing mail is signed. Incoming mail is checked against SPF, DMARC and spam lists.
Users and mailboxes are separate
A user logs in, a mailbox holds the mail. Several personal mailboxes per user, shared mailboxes with members.
A web client people like
Folders, search, contacts, notes. Six themes, high contrast, keyboard and screen reader support. English, Russian, Ukrainian.
Admin panel
Users and roles, mailboxes, a base set of mailboxes for every new user, sending limits.
HTTPS by itself
Let's Encrypt certificate for your mail host, renewed without restarts. TLS for SMTP and IMAP too.
Try it on your computer
No domain, no DNS: the web client and mail programs on your own machine, mail stays inside.
- Save the file
Put the compose file from this page into an empty folder asdocker-compose.yml. - Start it
docker compose up -d - Open the web mail
http://localhost:8080, log in asadmin@example.testwithadmin-password. - Going live?
Follow the install guide on Docker Hub: a server with port 25, a domain and six DNS records.
name: synth-mail-local
services:
db:
image: postgres:17
environment:
POSTGRES_DB: mailserver
POSTGRES_USER: mail
POSTGRES_PASSWORD: local-db-password
volumes:
- pgdata:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U mail -d mailserver"]
interval: 5s
retries: 20
mail:
image: liosha/synth-mail:latest
depends_on:
db:
condition: service_healthy
ports:
- "127.0.0.1:8080:8080" # web mail
- "127.0.0.1:587:3025" # SMTP (STARTTLS)
- "127.0.0.1:993:3993" # IMAP (SSL/TLS)
environment:
DB_HOST: db
DB_PASSWORD: local-db-password
JWT_SECRET: local-jwt-secret-at-least-32-bytes-long
MAIL_DOMAINS: example.test
MAIL_HOSTNAME: localhost
MAIL_ADMIN_PASSWORD: admin-password
IMAPS_PORT: "3993"
OUTBOUND_MODE: "off"
volumes:
- data:/app/data
volumes:
pgdata:
data:What you need for real mail
- A server with port 25 openMany cloud providers block it by default: ask them to open it.
- Reverse DNS (PTR)For the server's public address, set in your provider's panel.
- A domainWhere you can edit DNS records: A, MX, SPF, DKIM, DMARC.
- Docker with ComposeAbout 1 GB of free memory.
Free for any use
Including commercial use. Run it for yourself, your team or your clients. Questions and ideas: hello@synth-mail.com.