1MSMTPD(1)                   General Commands Manual                  MSMTPD(1)
2
3
4

NAME

6       msmtpd - A minimal SMTP server
7

SYNOPSIS

9       msmtpd [option...]
10

DESCRIPTION

12       Msmtpd  is  a  minimal  SMTP  server that pipes mails to msmtp (or some
13       other program) for delivery.  It is intended to  be  used  with  system
14       services  that  expect  an  SMTP server on the local host and cannot be
15       configured to use the sendmail interface that msmtp provides.
16       Msmtpd handles local SMTP clients. It listens on 127.0.0.1 port  25  by
17       default,  but  can  also  run  without its own network sockets in inetd
18       mode, where it handles a single SMTP session on standard input  /  out‐
19       put.
20       In  the string that defines the command that msmtpd pipes each mail to,
21       the first occurrence of %F will be  replaced  with  the  envelope  from
22       address.  Furthermore,  all  recipients of the mail will be appended as
23       arguments. The command must not write to standard output, as that would
24       mess up the SMTP session.
25       Only  run msmtpd if you know you need it. Only use a local interface to
26       listen on. Take care to run it with correct user rights and permissions
27       (e.g. use CAP_NET_BIND_SERVICE to bind to port 25 instead of running as
28       root, or use systemd with inetd service capabilities).  Be  aware  that
29       the pipe command will be run as the same user that msmtpd runs as.
30

OPTIONS

32       --version
33              Print version information
34
35       --help Print help
36
37       --inetd
38              Start single SMTP session on stdin/stdout
39
40       --interface=ip
41              Listen on the given IPv6 or IPv4 address instead of 127.0.0.1
42
43       --port=number
44              Listen on the given port number instead of 25
45
46       --command=cmd
47              Pipe mails to cmd instead of msmtp
48

EXAMPLES

50       Managing msmtpd with start-stop-daemon
51       # start msmtpd
52       start-stop-daemon  --start --pidfile /var/run/msmtpd.pid --make-pidfile
53       --chuid msmtpd --background --exec /usr/local/bin/msmtpd  --  --command
54       '/usr/local/bin/msmtp -f %F'
55       # stop msmtpd
56       start-stop-daemon  --stop   --pidfile /var/run/msmtpd.pid --remove-pid‐
57       file --quiet --signal TERM
58

SEE ALSO

60       msmtp(1)
61
62
63
64                                    2018-08                          MSMTPD(1)