Chatmail relays for end-to-end encrypted e-mail

• Getting started
  • Minimal requirements and prerequisites
  • Setup with “script/cmdeploy”
  • Other helpful commands
  • Modifying the home page
  • Refining the web pages
  • Custom web pages
• Services and internal structure
  • cmdeploy
  • chatmaild
  • Mailbox directory layout
  • Active ports
  • Email authentication
  • TLS requirements
• Setting up a reverse proxy
• Migrating to a new host
• Troubleshooting
  • Disable automatic address creation
• Related projects and community efforts
• Architecture

Chatmail relay servers are interoperable Mail Transport Agents (MTAs) designed for:

• Convenience: Low friction instant onboarding

• Privacy: No name, phone numbers, email required or collected

• End-to-End Encryption enforced: only OpenPGP messages with metadata minimization allowed

• Instant: Privacy-preserving Push Notifications for Apple, Google, and Huawei

• Speed: Message delivery in half a second, with optional P2P realtime connections

• Transport Security: Strict TLS and DKIM enforced

• Reliability: No spam or IP reputation checks; rate-limits are suitable for realtime chats

• Efficiency: Messages are only stored for transit and removed automatically

This repository contains everything needed to setup a ready-to-use chatmail relay comprised of a minimal setup of the battle-tested Postfix SMTP and Dovecot IMAP MTAs/MDAs.

The automated setup is designed and optimized for providing chatmail addresses for immediate permission-free onboarding through chat apps and bots. Chatmail addresses are automatically created at first login, after which the initially specified password is required for sending and receiving messages through them.

• list of known apps and client projects

• this list of known public 3rd party chatmail relay servers.