chatmail/relay

chatmail service deployment scripts and docs

Python

484

1,328 commits

updated Sep 17, 2026

See the code

README

Chatmail relays for end-to-end encrypted email

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

  • Zero State: no private data or metadata collected, messages are auto-deleted, low disk usage

  • Instant/Realtime: sub-second message delivery, realtime P2P streaming, privacy-preserving Push Notifications for Apple, Google, and Huawei;

  • Security Enforcement: Only connections with strict TLS are accepted; all messages must be correctly signed with DKIM and OpenPGP-encrypted with minimized metadata. There are experimental exceptions for no-DNS relays, which are allowed use self-signed TLS certificates and which do not need to DKIM-sign their messages. Unencrypted messages are allowed in neither case.

  • Reliable Federation and Decentralization: No spam or IP reputation checks, federating depends on established IETF standards and protocols.

This repository contains everything needed to setup a ready-to-use chatmail relay on an ssh-reachable host. For getting started and more information please refer to the web version of this repositories' documentation at

https://chatmail.at/doc/relay

chatmail
dovecot
email
opendkim
postfix
pyinfra

Contributors

(top 30 of 31)

hpk42

443 commits

missytake

397 commits

link2xt

246 commits

hagenest

51 commits

chatmail/relay

chatmail service deployment scripts and docs

Python

484

1,328 commits

updated Sep 17, 2026

See the code

README

Chatmail relays for end-to-end encrypted email

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

  • Zero State: no private data or metadata collected, messages are auto-deleted, low disk usage

  • Instant/Realtime: sub-second message delivery, realtime P2P streaming, privacy-preserving Push Notifications for Apple, Google, and Huawei;

  • Security Enforcement: Only connections with strict TLS are accepted; all messages must be correctly signed with DKIM and OpenPGP-encrypted with minimized metadata. There are experimental exceptions for no-DNS relays, which are allowed use self-signed TLS certificates and which do not need to DKIM-sign their messages. Unencrypted messages are allowed in neither case.

  • Reliable Federation and Decentralization: No spam or IP reputation checks, federating depends on established IETF standards and protocols.

This repository contains everything needed to setup a ready-to-use chatmail relay on an ssh-reachable host. For getting started and more information please refer to the web version of this repositories' documentation at

https://chatmail.at/doc/relay

chatmail
dovecot
email
opendkim
postfix
pyinfra

Contributors

(top 30 of 31)

hpk42

443 commits

missytake

397 commits

link2xt

246 commits

hagenest

51 commits

Languages

Python

85.5%

Jinja

10.4%

Filebench WML

1.6%

Shell

1.3%