---

13.3.12 Mail Home Services

The (gnu home services mail) module provides services that help you set up the tools to work with emails in your home environment.

MSMTP is a SMTP (Simple Mail Transfer Protocol) client. It sends mail to a predefined SMTP server that takes care of proper delivery.

The service reference is given below.

Variable: home-msmtp-service-type

This is the service type for msmtp. Its value must be a home-msmtp-configuration, as shown below. It provides the ~/.config/msmtp/config file.

As an example, here is how you would configure msmtp for a single account:

(service home-msmtp-service-type
         (home-msmtp-configuration
          (accounts
           (list
            (msmtp-account
             (name "alice")
             (configuration
              (msmtp-configuration
               (host "mail.example.org")
               (port 587)
               (user "alice")
               (password-eval "pass Mail/alice"))))))))

Data Type: home-msmtp-configuration

Available home-msmtp-configuration fields are:

defaults (type: msmtp-configuration)

The configuration that will be set as default for all accounts.

accounts (default: '()) (type: list-of-msmtp-accounts)

A list of msmtp-account records which contain information about all your accounts.

default-account (type: maybe-string)

Set the default account.

extra-content (default: "") (type: string)

Extra content appended as-is to the configuration file. Run man msmtp for more information about the configuration file format.

Data Type: msmtp-account

Available msmtp-account fields are:

name (type: string)

The unique name of the account.

configuration (type: msmtp-configuration)

The configuration for this given account.

Data Type: msmtp-configuration

Available msmtp-configuration fields are:

auth? (type: maybe-boolean)

Enable or disable authentication.

tls? (type: maybe-boolean)

Enable or disable TLS (also known as SSL) for secured connections.

tls-starttls? (type: maybe-boolean)

Choose the TLS variant: start TLS from within the session (‘on’, default), or tunnel the session through TLS (‘off’).

tls-trust-file (type: maybe-string)

Activate server certificate verification using a list of trusted Certification Authorities (CAs).

log-file (type: maybe-string)

Enable logging to the specified file. An empty argument disables logging. The file name ‘-’ directs the log information to standard output.

host (type: maybe-string)

The SMTP server to send the mail to.

port (type: maybe-integer)

The port that the SMTP server listens on. The default is 25 ("smtp"), unless TLS without STARTTLS is used, in which case it is 465 ("smtps").

user (type: maybe-string)

Set the user name for authentication.

from (type: maybe-string)

Set the envelope-from address.

password-eval (type: maybe-string)

Set the password for authentication to the output (stdout) of the command cmd.

extra-content (default: "") (type: string)

Extra content appended as-is to the configuration block. Run man msmtp for more information about the configuration file format.