2023-10-12 15:06:48 +02:00
|
|
|
# Chat Mail server configuration
|
|
|
|
|
|
|
|
|
|
This package deploys Postfix and Dovecot servers, including OpenDKIM for DKIM signing.
|
|
|
|
|
|
|
|
|
|
Postfix uses Dovecot for authentication as described in <https://www.postfix.org/SASL_README.html#server_dovecot>
|
|
|
|
|
|
2023-10-13 15:36:42 +02:00
|
|
|
## Structure (wip)
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
# package doveauth tool and deploy chatmail server to a envvar-specified ssh-reachable host
|
|
|
|
|
deploy.py
|
|
|
|
|
|
|
|
|
|
# chatmail pyinfra deploy package
|
|
|
|
|
pyinfra-src
|
|
|
|
|
pyproject.toml
|
|
|
|
|
chatmail/__init__ ...
|
|
|
|
|
|
|
|
|
|
# tests against the deployed system
|
|
|
|
|
tests/test_online_test.py
|
|
|
|
|
|
|
|
|
|
# doveauth tool used by dovecot's auth mechanism on the host system
|
|
|
|
|
doveauth-src
|
|
|
|
|
README.md
|
|
|
|
|
pyproject.toml
|
|
|
|
|
doveauth.py
|
|
|
|
|
doveauth.lua
|
|
|
|
|
test_doveauth.py
|
|
|
|
|
```
|
|
|
|
|
|
2023-10-12 15:06:48 +02:00
|
|
|
## Ports
|
|
|
|
|
|
|
|
|
|
Postfix listens on ports 25 (smtp) and 587 (submission) and 465 (submissions).
|
|
|
|
|
Dovecot listens on ports 143(imap) and 993 (imaps).
|
|
|
|
|
|
|
|
|
|
## DNS
|
|
|
|
|
|
|
|
|
|
For DKIM you must add a DNS entry as in /etc/opendkim/selector.txt (where selector is the opendkim_selector configured in the chatmail inventory).
|
2023-10-12 17:00:20 +02:00
|
|
|
|
|
|
|
|
## Run with pyinfra
|
|
|
|
|
|
|
|
|
|
```
|
2023-10-13 16:06:30 +02:00
|
|
|
CHATMAIL_DOMAIN=c1.testrun.org pyinfra --ssh-user root c1.testrun.org deploy.py
|
2023-10-12 17:00:20 +02:00
|
|
|
```
|
