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.
- Create a second user in Admin panel → USERS and send mail between the two mailboxes.
- Connect a mail program with an app password (Settings → APP PASSWORDS): IMAP
localhost:993SSL/TLS, SMTPlocalhost:587STARTTLS. Without a real certificate the server uses a self-signed one, so the program asks you to accept it.
Remove it
docker compose down -v
-v also deletes the volumes with the mail. Ready for real mail? Go to Install on a server.