Mail Home Services (Manual de referência do GNU Guix)

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.

Variável: 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.