SYNTH MAIL

Try it on your computer

No domain, no DNS: the web client and mail programs on your own machine. Mail stays inside — nothing is sent to the internet.

You need Docker with Compose and about 1 GB of free memory.

1. Save the compose file

Create an empty folder and save this as docker-compose.yml:

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: jambotron/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:

2. Start it

docker compose up -d

The first start takes about half a minute: the database is created and the server makes its keys.

3. Log in

Open http://localhost:8080 and log in as admin (or admin@example.test) with admin-password.

Remove it

docker compose down -v

-v also deletes the volumes with the mail. Ready for real mail? Go to Install on a server.