Synth Mail

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.

  1. Save the file
    Put the compose file from this page into an empty folder as docker-compose.yml.
  2. Start it
    docker compose up -d
  3. Open the web mail
    http://localhost:8080, log in as admin@example.test with admin-password.
  4. 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.