MSMTP(1) General Commands Manual MSMTP(1) (NAME) msmtp - SMTP (SYNOPSIS) sendmail (): msmtp [option...] [--] recipient... msmtp [option...] -t [--] [recipient...] : msmtp --configure : msmtp [option...] --serverinfo Remote Message Queue Starting: msmtp [option...] --rmqs=host|@domain|#queue (DESCRIPTION) sendmail msmtp SMTP . msmtp SMTP . Remote Message Queue Starting msmtp Remote Message Queue Starting SMTP . (EXIT STATUS) sendmail sysexits.h . (OPTIONS) . sendmail . --version . --help . -P, --pretend . ('*') . -v, -d, --debug SMTP. : ( ) ! --configure=mailaddress . . SRV RFC 8314 . -S, --serverinfo SMTP . ( TLS DSN ) TLS ( TLS) . --rmqs=(host|@domain|#queue) Remote Message Queue Starting SMTP . -C, --file=filename ~/.msmtprc $XDG_CONFIG_HOME/msmtp/config. -a, --account=account_name "default". . --host . --host=hostname SMTP . --account . --port=number . port . --source-ip=[IP] IP . source_ip . --proxy-host=[IP|hostname] SOCKS . proxy_host . --proxy-port=[number] . proxy_port . --socket=[socketname] . socket . --timeout=(off|seconds) (timeout) . timeout . --protocol=(smtp|lmtp) . protocol . --domain=[string] EHLO SMTP ( LHLO LMTP) Message-ID. domain . --auth[=(on|off|method)] . auth . --user=[username] . user . --passwordeval=[cmd] . passwordeval . --tls[=(on|off)] TLS/SSL. tls . --tls-starttls[=(on|off)] STARTTLS TLS. tls_starttls . --tls-trust-file=[file] (trust file) TLS. tls_trust_file . --tls-crl-file=[file] . (CRL) TLS. tls_crl_file . --tls-fingerprint=[fingerprint] (fingerprint) TLS. tls_fingerprint . --tls-key-file=[file] TLS. tls_key_file . --tls-cert-file=[file] TLS. tls_cert_file . --tls-certcheck[=(on|off)] TLS. tls_certcheck . --tls-priorities=[priorities] TLS. tls_priorities . --tls-host-override=[host] TLS. tls_host_override . --tls-min-dh-prime-bits=[bits] --tls-priorities . - (DH). tls_min_dh_prime_bits . sendmail -f, --from=address envelope-from. ( --account --host) envelope-from ( from) . "default" . from allow_from_override . -N, --dsn-notify=(off|cond) DSN. dsn_notify . -R, --dsn-return=(off|ret) DSN. dsn_return . hdrs sendmail headers . --set-from-header[=(auto|on|off)] From. set_from_header . --set-date-header[=(auto|off)] Date. set_date_header . --set-msgid-header[=(auto|off)] Message-ID. set_msgid_header . --set-to-header[=(on|off|undisclosed_recipients)] To. set_to_header . --remove-bcc-headers[=(on|off)] Bcc. remove_bcc_headers . -X, --logfile=[file] . logfile . --logfile-time-format=[fmt] . logfile_time_format . --syslog[=(on|off|facility)] syslog. syslog . -t, --read-recipients To Cc Bcc . Resent- Resent-To Resent-Cc Resent-Bcc Resent- ..IP "--read-envelope-from" (envelope-from) From Resent-From From . %F envelope-from from . --aliases=[file] (aliases). aliases . -Fname From msmtp . from_full_name . --auto-from[=(on|off)] . auto_from . --maildomain=[domain] . maildomain . -- . <<->> . sendmail : -Amode, -Btype, -bm, -G, -hN, -i, -L tag, -m, -n, -O option=value, -ox value (USAGE) --configure . / SMTP . SMTP (accounts) . SMTP : TLS . . : --account=id . . --host=hostname . --from=address --read-envelope-from envelope-from from . --account --host . (Subaddresses) . envelope-from user+detail@example.com user@example.com . envelope- from (wildcard) . from . ( from ) <> . msmtp SMTP : - () Bcc . remove_bcc_headers --remove-bcc-headers . - From . set_from_header --set-from-header . envelope-from -F from_full_name . - Date . set_date_header --set-date-header . - Message-ID . set_msgid_header --set-msgid-header . - set_to_header To Cc Bcc To . << (EXAMPLES)>> . (CONFIGURATION FILES) SYSCONFDIR/msmtprc SYSCONFDIR . --version . ( ~/.msmtprc $XDG_CONFIG_HOME/msmtp/config --version ). . . . ( <<#>> ) . . (") . (~) $HOME . on on . . account SMTP . << (EXAMPLES)>> . : defaults . . account name [:account[,...]] . . . eval cmd (stdout) cmd. . eval echo host localhost host localhost . eval . cmd < /dev/null . eval password cmd passwordeval . . host hostname SMTP . . . port number SMTP . 25 ("smtp") TLS STARTTLS 465 ("smtps") . source_ip [IP] IP (bind) . (multi-home) . . proxy_host [IP|hostname] SOCKS. DNS DNS ( IP ). hostname . SOCKS 5 . Tor << msmtp Tor>> . proxy_port [number] . number . socket socketname (unix domain socket) . host/port proxy_host/proxy_port . timeout (off|seconds) (network timeout) . off . protocol (smtp|lmtp) . SMTP LMTP . SMTP . port . domain argument SMTP EHLO ( LMTP LHLO) Message-ID msmtp ( set_msgid_header ). localhost EHLO . Message-ID . set_msgid_header . (provider.example joe@provider.example) (FQDN) ( ) . : %H $HOSTNAME . %C (canonical name) %H . %M /etc/mailname ( msmtp --version )..IP "auth [(on|off|method)]" . on . . user . : . . Gnome Mac OS X Keychain. Gnome secret-tool ( libsecret ) : secret-tool store --label=msmtp host mail.freemail.example service smtp user joe.smith. Mac OS X : security add-internet-password -s mail.freemail.example -r smtp -a joe.smith -w. mail.freemail.example SMTP joe.smith . . passwordeval GnuPG. EXAMPLES . . password. ( . .) . ~/.netrc. . . . . . . / : plain ( base64 ) scram-sha-1 scram-sha-1-plus ( ( ) . -plus TLS ) scram-sha-256 scram-sha-256-plus ( ) cram-md5 ( ) digest-md5 ( ) login ( plain ) ntlm ( ntlmdomain ). msmtp . TLS : scram-sha-256-plus scram-sha-1-plus scram-sha-256 scram-sha-1 plain . TLS scram-sha-256 scram-sha-1 . / : oauthbearer xoauth2 ( OAuth2 . . passwordeval msmtp ) external ( TLS ) gssapi ( Kerberos ). . --version . user login . . password secret . . passwordeval . passwordeval [cmd] (stdout) cmd. . cmd < /dev/null . ntlmdomain [domain] ntlm. . tls [(on|off)] TLS ( SSL ) . (TLS) <<... . / >> ( RFC2246). TLS : STARTTLS ( TLS STARTTLS ) (TLS ). tls_starttls . TLS . (CA) . ( CA .) CA tls_trust_file . "system" CA . CA . CA . . . CA . tls_fingerprint . CA . . . --serverinfo --tls --tls-certcheck=off . CA ( tls_trust_file CA ) ( tls_fingerprint ) . TLS . CA . . tls_cert_file tls_key_file . / . external auth . URI GnuTLS tls_cert_file tls_key_file . URI p11tool --list-privkeys --login ( p11tool GnuTLS ). PIN ( passwordeval password) . tls_starttls [(on|off)] TLS: TLS (on ) TLS (off). tls_trust_file file (CA) . "system" . CA . PEM tls_crl_file . tls_crl_file [file] (CRL) TLS ( ). OCSP CRL . GnuTLS OCSP (stapled) MustStaple TLS OCSP OCSP . TLS . tls_fingerprint [fingerprint] TLS. ( tls_trust_file ). SHA256 SHA1 MD5 ( ). 01:23:45:67:.... . --serverinfo --tls --tls-certcheck=off --tls-fingerprint= . tls_key_file file ( tls_cert_file} ). PEM . ..IP "tls_cert_file file" ( tls_key_file ). PEM . . tls_certcheck [(on|off)] . . tls_trust_file tls_fingerprint . : TLS ! tls_priorities [priorities] TLS. TLS . priorities TLS . --version TLS . GnuTLS Priority Strings . libtls priorites PROTOCOLS= CIPHERS= ECDHECURVES= . tls_config_parse_protocols tls_config_set_ciphers tls_config_set_ecdhecurves . priorities . : "PROTOCOLS=TLSv1.3 CIPHERS=ECDHE-RSA-AES128-SHA256 ECDHECURVES=P-384". tls_host_override [host] TLS host . . . tls_min_dh_prime_bits [bits] tls_priorities . Diffie-Hellman (DH) TLS. TLS . ( 512 ) TLS . from envelope_from envelope-from. : %F From Resent-From From . %U $USER $LOGNAME msmtp . %H $HOSTNAME . %C (canonical name) %H . %M /etc/mailname ( msmtp --version ). auto_from envelope-from . envelope-from -f / --from allow_from_override . envelope- from (wildcard) . ? * [ . envelope-from --from . from_full_name name From msmtp . set_from_header . allow_from_override (on|off) --from from . off . dsn_notify (off|condition) DSN ( - Delivery Status Notification) . off DSN DSN . . condition never ( !) : failure delay success . SMTP DSN . dsn_return (off|amount) DSN ( ) . off DSN DSN . . amount headers full . SMTP DSN . set_from_header [(auto|on|off)] From: auto From ( ) on From off From . From envelope-from ( ) on . From envelope-from . envelope-from allow_from_override . add_missing_from_header [(on|off)] auto off . set_date_header [(auto|off)] Date: auto Date ( ) off Date . add_missing_date_header [(on|off)] auto off . set_msgid_header [(auto|off)] Message-ID: auto Message-ID ( ) off Message-ID . Message-ID hash@domain hash domain domain ( localhost ) envelope-from ( ) SMTP . set_to_header [(on|off|undisclosed_recipients)] on undisclosed_recipients To Cc Bcc To . on . undisclosed_recipients To "To: undisclosed-recipients:;" . off . undisclosed_recipients [(on|off)] undisclosed_recipients off . remove_bcc_headers [(on|off)] Bcc . . logfile [file] ( ). msmtp . : logfile_time_format SMTP TLS ( ) envelope-from ( ) SMTP SMTP ( ) ( ) ( sysexits.h EX_OK ). (-) msmtp . logfile_time_format [fmt] . strftime() . ("%b %d %H:%M:%S"). none . syslog [(on|off|facility)] syslog. (facility) LOG_USER LOG_MAIL LOG_LOCAL0 ... LOG_LOCAL7 . LOG_USER . msmtp syslog facility syslog . : SMTP TLS envelope-from ( ) SMTP SMTP ( ) ( ) ( sysexits.h EX_OK ). aliases [file] (aliases). aliases . : local: someone@example.com, person@domain.example . `#' . default aliases . default . . To Cc . aliases . ..IP "auto_from [(on|off)]" from . envelope-from. off . envelope-from user@domain . (local part) USER LOGNAME . maildomain . maildomain envelope-from . auto_from envelope-from . maildomain [domain] from . envelope-from. auto_from (on) . . (EXAMPLES) # ~/.msmtprc # # TLS . # (logging) (timeouts) SOCKS TLS # (DSN) . # . defaults # 587 SMTP 25. port 587 # TLS . tls on # CA TLS. # . #tls_trust_file /etc/ssl/certs/ca-certificates.crt # account freemail # SMTP host smtp.freemail.example # tls_trust_file tls_fingerprint # . # # . : # $ msmtp --serverinfo --tls --tls-certcheck=off --host=smtp.freemail.example #tls_fingerprint 00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11 :22:33 # Envelope-from from joe_smith@freemail.example # . . auth on user joe.smith # : (keyring) msmtp # . libsecret : # $ secret-tool store --label=msmtp \ # host smtp.freemail.example \ # service smtp \ # user joe.smith # : msmtp # . GnuPG . # gpg-agent . passwordeval gpg2 --no-tty -q -d ~/.msmtp-password.gpg # : . # . # . #password secret123 # : ~/.netrc. # . # : . msmtp # . msmtp . # account freemail2 : freemail from joey@freemail.example # SMTP (ISP) account isp host mail.isp.example from smithjoe@isp.example auth on user 12345 # account default : freemail msmtp Mutt msmtp Mutt : set sendmail="/path/to/msmtp" set use_from=yes set realname="Your Name" set from=you@example.com set envelope_from=yes envelope_from=yes Mutt -f msmtp . msmtp you@example.com . -a : set sendmail="/path/to/msmtp -a my-account" ( ): set sendmail="/path/to/msmtp --host=mailhub -f me@example.com --tls --tls-trust-file=trust.crt".PP msmtp Mutt -f Mutt : macro generic "1" ":set from=you@example.com" macro generic "2" ":set from=you@your-employer.example" macro generic "3" ":set from=you@some-other-provider.example" msmtp mail ~/.mailrc : set sendmail="/path/to/msmtp" msmtp Tor : proxy_host 127.0.0.1 proxy_port 9050 tls on IP msmtp DNS . TLS SMTP (exit hosts) . domain ( ). (Aliases) # (aliases file) # Joe Jane root root: joe_smith@example.com, jane_chang@example.com # Mark cron cron: mark_jones@example.com # admin default: admin@domain.example (FILES) SYSCONFDIR/msmtprc . --version SYSCONFDIR . ~/.msmtprc $XDG_CONFIG_HOME/msmtp/config . ~/.netrc SYSCONFDIR/netrc netrc . msmtp ~/.netrc SYSCONFDIR/netrc . (ENVIRONMENT) USER, LOGNAME envelope-from . LOGNAME USER . EMAIL, SMTPSERVER --host --account . SMTPSERVER envelope-from EMAIL --from --read-envelope-from . SMTPSERVER ( URL) EMAIL ( ) . (AUTHORS) msmtp Martin Lambers . AUTHORS ..SH " (SEE ALSO)" sendmail(8), netrc(5) ftp(1) 2024-10 MSMTP(1)