Files
chasquid/docs/clients.md
Alberto Bertogli 8b056823e6 docs: Add a "Clients" document
We've had a couple of reported issues about the difficulty of setting up
new clients, or confusion due to using broken clients:

- https://github.com/albertito/chasquid/pull/46
- https://github.com/albertito/chasquid/issues/52

This patch adds the first version of a "Clients" document that includes
requirements for all clients, configuration examples, and a list of
known-problematic client software.

The goal is to help reduce friction and confusion when setting up
clients.

The document needs more polishing and examples, which hopefully will be
added later.

Fixes https://github.com/albertito/chasquid/issues/48.
2024-02-06 00:50:30 +00:00

1.3 KiB

Clients

chasquid supports most SMTP clients, but requires them to have some features:

All modern clients should support both, and thus have no problems talking to chasquid.

Configuration examples

msmtp

This example is useful as either per-user ~/.msmtprc or system-wide /etc/msmtprc:

account default
tls on
auth on

# Use the SMTP submission port. Many providers block communications to the
# default port 25, but the submission port 587 tends to work just fine.
port 587

# Server hostname.
host SERVER

# Your username (including the domain).
user USER@DOMAIN

# Your password.
password SECRET

Replace the SERVER, USER@DOMAIN and SECRET strings with the appropriate values.

Problematic clients

These clients are known to have issues talking to chasquid:

  • ssmtp: does not support the PLAIN authentication method. It is also unmaintained.
    Please use msmtp instead.