1
0
mirror of https://blitiri.com.ar/repos/chasquid synced 2025-12-23 15:37:01 +00:00
Files
go-chasquid-smtp/docs/smarthost.md
Alberto Bertogli 0f2ffc8ff5 WIP: Add smarthost support
WORK IN PROGRESS -- WORK IN PROGRESS -- WORK IN PROGRESS

This patch adds support for delivering mail via a smarthost.

In this mode, all accepted mail gets delivered through an SMTP
connection to a specific host, statically configured.
2022-11-12 18:54:59 +00:00

42 lines
1.1 KiB
Markdown

# Smarthost client mode
As of version 1.6 (2020-XX), [chasquid] supports operating as a [smarthost]
client.
In this mode, chasquid will deliver all accepted mail (both local and remote)
to a single specific host (the *smarthost* server).
## Status
It is **EXPERIMENTAL** for now. The configuration options and behaviour can
change in backwards-incompatible ways.
## Security
chasquid will always negotiate TLS on the connection to the smarthost, and
expects a valid certificate.
If TLS is not available, or the certificate is not valid, the mail will remain
in the queue and will not be delivered.
## Configuring
Add the following line to `/etc/chasquid/chasquid.conf`:
```
smarthost_url: "smtp://user:password@server:587"
```
Replace `user` and `password` with the credentials used to authenticate to the
smarthost server, and `server:587` with the server address, including port.
You can also use the `tls` scheme for direct TLS connections (usually on port
465).
[chasquid]: https://blitiri.com.ar/p/chasquid
[smarthost]: https://en.wikipedia.org/wiki/Smart_host