git » chasquid » smarthost » tree

[smarthost] / docs / smarthost.md

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).