diff --git a/documentation/content/en/books/handbook/mail/_index.adoc b/documentation/content/en/books/handbook/mail/_index.adoc --- a/documentation/content/en/books/handbook/mail/_index.adoc +++ b/documentation/content/en/books/handbook/mail/_index.adoc @@ -4,7 +4,7 @@ prev: books/handbook/ppp-and-slip next: books/handbook/network-servers description: This chapter provides a basic introduction to running a mail server on FreeBSD, as well as an introduction to sending and receiving email using FreeBSD -tags: ["mail", "sendmail", "MTA", "SMTP", "user agents", "fetchmail", "procmail", "alpine", "mut"] +tags: ["mail", "sendmail", "dma", "MTA", "SMTP", "mail user agents", "fetchmail", "procmail", "alpine", "mutt"] showBookMenu: true weight: 36 path: "/books/handbook/" @@ -48,100 +48,173 @@ include::../../../../../shared/asciidoctor.adoc[] endif::[] +// Info: +// https://man.freebsd.org/cgi/man.cgi?query=dma +// https://wiki.mageia.org/en/Dma_Dragonfly_Mail_Agent +// https://www.dragonflybsd.org/handbook/mta/ +// https://herrbischoff.com/2021/10/freebsd-13-simple-outgoing-email-with-dma/ +// https://jpmens.net/2020/03/05/simple-solution-for-outgoing-mail-from-a-freebsd-system/ +// https://wiki.archlinux.org/title/Dma +// https://forums.freebsd.org/threads/dma-makes-sense.52219/ + [[mail-synopsis]] == Synopsis "Electronic Mail", better known as email, is one of the most widely used forms of communication today. -This chapter provides a basic introduction to running a mail server on FreeBSD, as well as an introduction to sending and receiving email using FreeBSD +This chapter provides a basic introduction to running a mail server on FreeBSD, as well as an introduction to sending and receiving email using FreeBSD. For more complete coverage of this subject, refer to the books listed in crossref:bibliography[bibliography,Bibliography]. -After reading this chapter, you will know: +This chapter covers: * Which software components are involved in sending and receiving electronic mail. +* How to configure DragonFly Mail Agent. * Where basic Sendmail configuration files are located in FreeBSD. * The difference between remote and local mailboxes. -* How to block spammers from illegally using a mail server as a relay. -* How to install and configure an alternate Mail Transfer Agent, replacing Sendmail. +* How to install and configure an alternate Mail Transfer Agent, replacing DragonFly Mail Agent or Sendmail. * How to troubleshoot common mail server problems. -* How to set up the system to send mail only. -* How to use mail with a dialup connection. -* How to configure SMTP authentication for added security. +* How to configure Sendmail to only send mail. +* How to configure SMTP authentication for added security in Sendmail. * How to install and use a Mail User Agent, such as mutt, to send and receive email. * How to download mail from a remote POP or IMAP server. * How to automatically apply filters and rules to incoming email. -Before reading this chapter, you should: - -* Properly set up a network connection (crossref:advanced-networking[advanced-networking,Advanced Networking]). -* Properly set up the DNS information for a mail host (crossref:network-servers[network-servers,Network Servers]). -* Know how to install additional third-party software (crossref:ports[ports,Installing Applications: Packages and Ports]). - [[mail-using]] == Mail Components -There are five major parts involved in an email exchange: the Mail User Agent (MUA), the Mail Transfer Agent (MTA), a mail host, a remote or local mailbox, and DNS. This section provides an overview of these components. +There are five major parts involved in an email exchange: the Mail User Agent (MUA), the Mail Transfer Agent (MTA), a mail host, a remote or local mailbox, and DNS. +This section provides an overview of these components. Mail User Agent (MUA):: The Mail User Agent (MUA) is an application which is used to compose, send, and receive emails. -This application can be a command line program, such as the built-in `mail` utility or a third-party application from the Ports Collection, such as mutt, alpine, or elm. +This application can be a command line program, such as the built-in `mail` utility or a third-party application from the Ports Collection, such as alpine, elm, or mutt. Dozens of graphical programs are also available in the Ports Collection, including Claws Mail, Evolution, and Thunderbird. Some organizations provide a web mail program which can be accessed through a web browser. More information about installing and using a MUA on FreeBSD can be found in <>. Mail Transfer Agent (MTA):: The Mail Transfer Agent (MTA) is responsible for receiving incoming mail and delivering outgoing mail. -FreeBSD ships with Sendmail as the default MTA, but it also supports numerous other mail server daemons, including Exim, Postfix, and qmail. -Sendmail configuration is described in <>. -If another MTA is installed using the Ports Collection, refer to its post-installation message for FreeBSD-specific configuration details and the application's website for more general configuration instructions. +Starting with FreeBSD version 14.0, the default MTA is DragonFly Mail Agent (man:dma[8]); in earlier versions, it is man:sedmail[8]. +Other MTAs, including Exim, Postfix, and qmail, may be installed to replace the default MTA. Mail Host and Mailboxes:: The mail host is a server that is responsible for delivering and receiving mail for a host or a network. -The mail host collects all mail sent to the domain and stores it either in the default [.filename]#mbox# or the alternative Maildir format, depending on the configuration. +The mail host collects all mail sent to the domain and stores it either in the default `mbox` or the alternative Maildir format, depending on the configuration. Once mail has been stored, it may either be read locally using a MUA or remotely accessed and collected using protocols such as POP or IMAP. If mail is read locally, a POP or IMAP server does not need to be installed. -+ -To access mailboxes remotely, a POP or IMAP server is required as these protocols allow users to connect to their mailboxes from remote locations. -IMAP offers several advantages over POP. -These include the ability to store a copy of messages on a remote server after they are downloaded and concurrent updates. -IMAP can be useful over low-speed links as it allows users to fetch the structure of messages without downloading them. -It can also perform tasks such as searching on the server in order to minimize data transfer between clients and servers. -+ -Several POP and IMAP servers are available in the Ports Collection. -These include package:mail/qpopper[], package:mail/imap-uw[], package:mail/courier-imap[], and package:mail/dovecot2[]. -+ -[WARNING] -==== -It should be noted that both POP and IMAP transmit information, including username and password credentials, in clear-text. -To secure the transmission of information across these protocols, consider tunneling sessions over man:ssh[1] (crossref:security[security-ssh-tunneling,"SSH Tunneling"]) or using SSL (crossref:security[openssl,"OpenSSL"]). -==== Domain Name System (DNS):: -The Domain Name System (DNS) and its daemon `named` play a large role in the delivery of email. +The Domain Name System (DNS) and its daemon man:named[8] play a large role in the delivery of mail. In order to deliver mail from one site to another, the MTA will look up the remote site in DNS to determine which host will receive mail for the destination. This process also occurs when mail is sent from a remote host to the MTA. -+ -In addition to mapping hostnames to IP addresses, DNS is responsible for storing information specific to mail delivery, known as Mail eXchanger MX records. -The MX record specifies which hosts will receive mail for a particular domain. -+ -To view the MX records for a domain, specify the type of record. -Refer to man:host[1], for more details about this command: -+ + +[[dragonFly-mail-agent]] +== DragonFly Mail Agent (DMA) + +DMA is the default MTA in FreeBSD starting with version 14.0. +It shines as a modern and efficient MTA that prioritizes simplicity and security, +making it an excellent choice for small-scale email setups and larger, more complex mail server deployments. + +[[configuring-dragonFly-mail-agent]] +=== Configuring DragonFly Mail Agent (DMA) + +DMA comes with a default configuration that will be suitable for many deployments. +Custom settings are defined in [.filename]#/etc/dma/dma.conf#, and SMTP authentication is configured in [.filename]#/etc/dma/auth.conf#. + +[[configuring-gmail-dma]] +==== Using DMA to Route Outgoing Mail through Gmail + +This example [.filename]#/etc/dma/dma.conf# can be used to send mail using Google's SMTP servers. + +[.programlisting] +.... +SMARTHOST smtp.gmail.com +PORT 587 +AUTHPATH /etc/dma/auth.conf +SECURETRANSFER +STARTTLS +MASQUERADE username@gmail.com +.... + +Authentication can be set with one line in [.filename]#/etc/dma/auth.conf#: + +[.programlisting] +.... +username@gmail.com|smtp.gmail.com:password +.... + +Execute the following command to test the configuration: + [source,shell] .... -% host -t mx FreeBSD.org -FreeBSD.org mail is handled by 10 mx1.FreeBSD.org +% echo this is a test | mail -v -s testing-email username@gmail.com +.... + +[[configuring-fastmail-dma]] +==== Using DMA to Route Outgoing Mail through Fastmail + +This example [.filename]#/etc/dma/dma.conf# can be used to send mail using Fastmail's SMTP servers. + +[.programlisting] +.... +SMARTHOST smtp.fastmail.com +PORT 465 +AUTHPATH /etc/dma/auth.conf +SECURETRANSFER +MAILNAME example.server.com +.... + +Authentication can be set with one line in [.filename]#/etc/dma/auth.conf#: + +[.programlisting] +.... +username@fastmail.com|smtp.fastmail.com:password +.... + +Execute the following command to test the configuration: + +[source,shell] +.... +% echo this is a test | mail -v -s testing-email username@fastmail.com +.... + +[[configuring-custom-dma]] +==== Using DMA to Route Outgoing Mail through a Custom Mail Host + +This example [.filename]#/etc/dma/dma.conf# can be used to send mail using a custom mail host. + +[.programlisting] +.... +SMARTHOST mail.example.org +PORT 587 +AUTHPATH /etc/dma/auth.conf +SECURETRANSFER +STARTTLS +.... + +Authentication can be set with one line in [.filename]#/etc/dma/auth.conf#: + +[.programlisting] +.... +username@example.org|mail.example.org:password +.... + +Execute the following command to test the configuration: + +[source,shell] +.... +% echo this is a test | mail -v -s testing-email username@example.org .... -+ -Refer to crossref:network-servers[network-dns,"Domain Name System (DNS)"] for more information about DNS and its configuration. [[sendmail]] -== Sendmail Configuration Files +== Sendmail -Sendmail is the default MTA installed with FreeBSD. It accepts mail from MUAs and delivers it to the appropriate mail host, as defined by its configuration. -Sendmail can also accept network connections and deliver mail to local mailboxes or to another program. +Sendmail is a venerable and versatile Mail Transfer Agent (MTA) with a long history in UNIX(R) and UNIX-like systems. +It was a part of the FreeBSD base system until FreeBSD 13, offering robust email transport capabilities, extensive customization options, and support for complex routing and filtering. -The configuration files for Sendmail are located in [.filename]#/etc/mail#. -This section describes these files in more detail. +[[configuring-sendmail]] +=== Configuration Files + +The configuration files for Sendmail are located in [.filename]#/etc/mail/#. [.filename]#/etc/mail/access#:: This access database file defines which hosts or IP addresses have access to the local mail server and what kind of access they have. @@ -154,26 +227,6 @@ + Examples of using these options for both IPv4 and IPv6 addresses can be found in the FreeBSD sample configuration, [.filename]#/etc/mail/access.sample#: + -[.programlisting] -.... -# $FreeBSD$ -# -# Mail relay access control list. Default is to reject mail unless the -# destination is local, or listed in /etc/mail/local-host-names -# -## Examples (commented out for safety) -#From:cyberspammer.com ERROR:"550 We don't accept mail from spammers" -#From:okay.cyberspammer.com OK -#Connect:sendmail.org RELAY -#To:sendmail.org RELAY -#Connect:128.32 RELAY -#Connect:128.32.2 SKIP -#Connect:IPv6:1:2:3:4:5:6:7 RELAY -#Connect:suspicious.example.com QUARANTINE:Mail from suspicious host -#Connect:[127.0.0.3] OK -#Connect:[IPv6:1:2:3:4:5:6:7:8] OK -.... -+ To configure the access database, use the format shown in the sample to make entries in [.filename]#/etc/mail/access#, but do not put a comment symbol (`+#+`) in front of the entries. Create an entry for each host or network whose access should be configured. Mail senders that match the left side of the table are affected by the action on the right side of the table. @@ -273,67 +326,46 @@ [[mail-changingmta]] == Changing the Mail Transfer Agent -FreeBSD comes with Sendmail already installed as the MTA which is in charge of outgoing and incoming mail. +Starting with FreeBSD version 14.0, man:dma[8] in the default MTA, and before 14.0, the default MTA is man:sendmail[8]. However, the system administrator can change the system's MTA. A wide choice of alternative MTAs is available from the `mail` category of the FreeBSD Ports Collection. -Once a new MTA is installed, configure and test the new software before replacing Sendmail. -Refer to the documentation of the new MTA for information on how to configure the software. - -Once the new MTA is working, use the instructions in this section to disable Sendmail and configure FreeBSD to use the replacement MTA. - -[[mail-disable-sendmail]] -=== Disable Sendmail - [WARNING] ==== - -If Sendmail's outgoing mail service is disabled, it is important that it is replaced with an alternative mail delivery system. +If the default's outgoing mail service is disabled, it is important that it is replaced with an alternative mail delivery system. Otherwise, system functions such as man:periodic[8] will be unable to deliver their results by email. Many parts of the system expect a functional MTA. -If applications continue to use Sendmail's binaries to try to send email after they are disabled, mail could go into an inactive Sendmail queue and never be delivered. +If applications continue to use the default binaries to try to send email after they are disabled, mail could go into an inactive queue and never be delivered. ==== -In order to completely disable Sendmail, add or edit the following lines in [.filename]#/etc/rc.conf#: - -[.programlisting] -.... -sendmail_enable="NO" -sendmail_submit_enable="NO" -sendmail_outbound_enable="NO" -sendmail_msp_queue_enable="NO" -.... +[[replace-sendmail-dma]] +=== Replacing Sendmail with Other MTA -To only disable Sendmail's incoming mail service, use only this entry in [.filename]#/etc/rc.conf#: +In order to completely disable man:sendmail[8] execute the following commands: -[.programlisting] +[source,shell] .... -sendmail_enable="NO" +# sysrc sendmail_enable="NO" +# sysrc sendmail_submit_enable="NO" +# sysrc sendmail_outbound_enable="NO" +# sysrc sendmail_msp_queue_enable="NO" .... -More information on Sendmail's startup options is available in man:rc.sendmail[8]. - -=== Replace the Default MTA - -When a new MTA is installed using the Ports Collection, its startup script is also installed and startup instructions are mentioned in its package message. -Before starting the new MTA, stop the running Sendmail processes. -This example stops all of these services, then starts the Postfix service: +To only disable man:sendmail[8]'s incoming mail service execute the following command: [source,shell] .... -# service sendmail stop -# service postfix start +# sysrc sendmail_enable="NO" .... -To start the replacement MTA at system boot, add its configuration line to [.filename]#/etc/rc.conf#. -This entry enables the Postfix MTA: +Then stop the man:sendmail[8] service: -[.programlisting] +[source,shell] .... -postfix_enable="YES" +# service sendmail onestop .... -Some extra configuration is needed as Sendmail is so ubiquitous that some software assumes it is already installed and configured. +Some extra configuration is needed as man:sendmail[8] is so ubiquitous that some software assumes it is already installed and configured. Check [.filename]#/etc/periodic.conf# and make sure that these values are set to `NO`. If this file does not exist, create it with these entries: @@ -345,444 +377,77 @@ daily_submit_queuerun="NO" .... -Some alternative MTAs provide their own compatible implementations of the Sendmail command-line interface in order to facilitate using them as drop-in replacements for Sendmail. -However, some MUAs may try to execute standard Sendmail binaries instead of the new MTA's binaries. -FreeBSD uses [.filename]#/etc/mail/mailer.conf# to map the expected Sendmail binaries to the location of the new binaries. -More information about this mapping can be found in man:mailwrapper[8]. - -The default [.filename]#/etc/mail/mailer.conf# looks like this: +The next step is to install another MTA, man:dma[8] will be used in this example. +To install it execute the following command: -[.programlisting] +[source,shell] .... -# $FreeBSD$ -# -# Execute the "real" sendmail program, named /usr/libexec/sendmail/sendmail -# -sendmail /usr/libexec/sendmail/sendmail -send-mail /usr/libexec/sendmail/sendmail -mailq /usr/libexec/sendmail/sendmail -newaliases /usr/libexec/sendmail/sendmail -hoststat /usr/libexec/sendmail/sendmail -purgestat /usr/libexec/sendmail/sendmail +# pkg install dma .... -When any of the commands listed on the left are run, the system actually executes the associated command shown on the right. -This system makes it easy to change what binaries are executed when these default binaries are invoked. +Perform the configuration as indicated in <>. -Some MTAs, when installed using the Ports Collection, will prompt to update this file for the new binaries. -For example, Postfix will update the file like this: +Then change all the entries in the file [.filename]#/etc/mail/mailer.conf# to man:dma[8]: [.programlisting] .... +# $FreeBSD$ # -# Execute the Postfix sendmail program, named /usr/local/sbin/sendmail +# Execute the "real" sendmail program, named /usr/libexec/sendmail/sendmail # -sendmail /usr/local/sbin/sendmail -send-mail /usr/local/sbin/sendmail -mailq /usr/local/sbin/sendmail -newaliases /usr/local/sbin/sendmail -.... - -If the installation of the MTA does not automatically update [.filename]#/etc/mail/mailer.conf#, edit this file in a text editor so that it points to the new binaries. -This example points to the binaries installed by package:mail/ssmtp[]: - -[.programlisting] -.... -sendmail /usr/local/sbin/ssmtp -send-mail /usr/local/sbin/ssmtp -mailq /usr/local/sbin/ssmtp -newaliases /usr/local/sbin/ssmtp -hoststat /usr/bin/true -purgestat /usr/bin/true +# If dma(8) is installed, an example mailer.conf that uses dma(8) instead can +# be found in /usr/share/examples/dma +# +sendmail /usr/libexec/dma +mailq /usr/libexec/dma +newaliases /usr/libexec/dma .... Once everything is configured, it is recommended to reboot the system. Rebooting provides the opportunity to ensure that the system is correctly configured to start the new MTA automatically on boot. -[[mail-trouble]] -== Troubleshooting - -=== Why do I have to use the FQDN for hosts on my site? - -The host may actually be in a different domain. -For example, in order for a host in `foo.bar.edu` to reach a host called `mumble` in the `bar.edu` domain, refer to it by the Fully-Qualified Domain Name FQDN, `mumble.bar.edu`, instead of just `mumble`. - -This is because the version of BIND which ships with FreeBSD no longer provides default abbreviations for non-FQDNs other than the local domain. -An unqualified host such as `mumble` must either be found as `mumble.foo.bar.edu`, or it will be searched for in the root domain. - -In older versions of BIND, the search continued across `mumble.bar.edu`, and `mumble.edu`. -RFC 1535 details why this is considered bad practice or even a security hole. - -As a good workaround, place the line: - -[.programlisting] -.... -search foo.bar.edu bar.edu -.... - -instead of the previous: - -[.programlisting] -.... -domain foo.bar.edu -.... - -into [.filename]#/etc/resolv.conf#. -However, make sure that the search order does not go beyond the "boundary between local and public administration", as RFC 1535 calls it. - -=== How can I run a mail server on a dial-up PPP host? - -Connect to a FreeBSD mail gateway on the LAN. The PPP connection is non-dedicated. - -One way to do this is to get a full-time Internet server to provide secondary MX services for the domain. -In this example, the domain is `example.com` and the ISP has configured `example.net` to provide secondary MX services to the domain: - -[.programlisting] -.... -example.com. MX 10 example.com. - MX 20 example.net. -.... - -Only one host should be specified as the final recipient. -For Sendmail, add `Cw example.com` in [.filename]#/etc/mail/sendmail.cf# on `example.com`. - -When the sending MTA attempts to deliver mail, it will try to connect to the system, `example.com`, over the PPP link. -This will time out if the destination is offline. -The MTA will automatically deliver it to the secondary MX site at the Internet Service Provider (ISP), `example.net`. -The secondary MX site will periodically try to connect to the primary MX host, `example.com`. - -Use something like this as a login script: - -[.programlisting] -.... -#!/bin/sh -# Put me in /usr/local/bin/pppmyisp -( sleep 60 ; /usr/sbin/sendmail -q ) & -/usr/sbin/ppp -direct pppmyisp -.... - -When creating a separate login script for users, instead use `sendmail -qRexample.com` in the script above. -This will force all mail in the queue for `example.com` to be processed immediately. - -A further refinement of the situation can be seen from this example from the {freebsd-isp}: - -[.programlisting] -.... -> we provide the secondary MX for a customer. The customer connects to -> our services several times a day automatically to get the mails to -> his primary MX (We do not call his site when a mail for his domains -> arrived). Our sendmail sends the mailqueue every 30 minutes. At the -> moment he has to stay 30 minutes online to be sure that all mail is -> gone to the primary MX. -> -> Is there a command that would initiate sendmail to send all the mails -> now? The user has not root-privileges on our machine of course. - -In the privacy flags section of sendmail.cf, there is a -definition Opgoaway,restrictqrun - -Remove restrictqrun to allow non-root users to start the queue processing. -You might also like to rearrange the MXs. We are the 1st MX for our -customers like this, and we have defined: - -# If we are the best MX for a host, try directly instead of generating -# local config error. -OwTrue - -That way a remote site will deliver straight to you, without trying -the customer connection. You then send to your customer. Only works for -hosts, so you need to get your customer to name their mail -machine customer.com as well as -hostname.customer.com in the DNS. Just put an A record in -the DNS for customer.com. -.... - -[[mail-advanced]] -== Advanced Topics - -This section covers more involved topics such as mail configuration and setting up mail for an entire domain. - -[[mail-config]] -=== Basic Configuration - -Out of the box, one can send email to external hosts as long as [.filename]#/etc/resolv.conf# is configured or the network has access to a configured DNS server. -To have email delivered to the MTA on the FreeBSD host, do one of the following: - -* Run a DNS server for the domain. -* Get mail delivered directly to the FQDN for the machine. - -In order to have mail delivered directly to a host, it must have a permanent static IP address, not a dynamic IP address. -If the system is behind a firewall, it must be configured to allow SMTP traffic. -To receive mail directly at a host, one of these two must be configured: - -* Make sure that the lowest-numbered MX record in DNS points to the host's static IP address. -* Make sure there is no MX entry in the DNS for the host. - -Either of the above will allow mail to be received directly at the host. - -Try this: - -[source,shell] -.... -# hostname -example.FreeBSD.org -# host example.FreeBSD.org -example.FreeBSD.org has address 204.216.27.XX -.... - -In this example, mail sent directly to mailto:yourlogin@example.FreeBSD.org[yourlogin@example.FreeBSD.org] should work without problems, assuming Sendmail is running correctly on `example.FreeBSD.org`. - -For this example: - -[source,shell] -.... -# host example.FreeBSD.org -example.FreeBSD.org has address 204.216.27.XX -example.FreeBSD.org mail is handled (pri=10) by nevdull.FreeBSD.org -.... - -All mail sent to `example.FreeBSD.org` will be collected on `hub` under the same username instead of being sent directly to your host. - -The above information is handled by the DNS server. -The DNS record that carries mail routing information is the MX entry. -If no MX record exists, mail will be delivered directly to the host by way of its IP address. - -The MX entry for `freefall.FreeBSD.org` at one time looked like this: - -[.programlisting] -.... -freefall MX 30 mail.crl.net -freefall MX 40 agora.rdrop.com -freefall MX 10 freefall.FreeBSD.org -freefall MX 20 who.cdrom.com -.... - -`freefall` had many MX entries. -The lowest MX number is the host that receives mail directly, if available. -If it is not accessible for some reason, the next lower-numbered host will accept messages temporarily, and pass it along when a lower-numbered host becomes available. - -Alternate MX sites should have separate Internet connections in order to be most useful. -Your ISP can provide this service. - -[[mail-domain]] -=== Mail for a Domain - -When configuring an MTA for a network, any mail sent to hosts in its domain should be diverted to the MTA so that users can receive their mail on the master mail server. - -To make life easiest, a user account with the same _username_ should exist on both the MTA and the system with the MUA. -Use man:adduser[8] to create the user accounts. - -The MTA must be the designated mail exchanger for each workstation on the network. -This is done in the DNS configuration with an MX record: - -[.programlisting] -.... -example.FreeBSD.org A 204.216.27.XX ; Workstation - MX 10 nevdull.FreeBSD.org ; Mailhost -.... - -This will redirect mail for the workstation to the MTA no matter where the A record points. -The mail is sent to the MX host. - -This must be configured on a DNS server. -If the network does not run its own DNS server, talk to the ISP or DNS provider. - -The following is an example of virtual email hosting. -Consider a customer with the domain `customer1.org`, where all the mail for `customer1.org` should be sent to `mail.myhost.com`. -The DNS entry should look like this: - -[.programlisting] -.... -customer1.org MX 10 mail.myhost.com -.... - -An `A` record is _not_ needed for `customer1.org` in order to only handle email for that domain. -However, running `ping` against `customer1.org` will not work unless an `A` record exists for it. - -Tell the MTA which domains and/or hostnames it should accept mail for. -Either of the following will work for Sendmail: - -* Add the hosts to [.filename]#/etc/mail/local-host-names# when using the `FEATURE(use_cw_file)`. -* Add a `Cwyour.host.com` line to [.filename]#/etc/sendmail.cf#. - -[[outgoing-only]] -== Setting Up to Send Only - -There are many instances where one may only want to send mail through a relay. -Some examples are: - -* The computer is a desktop machine that needs to use programs such as man:mail[1], using the ISP's mail relay. -* The computer is a server that does not handle mail locally, but needs to pass off all mail to a relay for processing. - -While any MTA is capable of filling this particular niche, it can be difficult to properly configure a full-featured MTA just to handle offloading mail. -Programs such as Sendmail and Postfix are overkill for this use. - -Additionally, a typical Internet access service agreement may forbid one from running a "mail server". - -The easiest way to fulfill those needs is to install the package:mail/ssmtp[] port: - -[source,shell] -.... -# cd /usr/ports/mail/ssmtp -# make install replace clean -.... - -Once installed, package:mail/ssmtp[] can be configured with [.filename]#/usr/local/etc/ssmtp/ssmtp.conf#: - -[.programlisting] -.... -root=yourrealemail@example.com -mailhub=mail.example.com -rewriteDomain=example.com -hostname=_HOSTNAME_ -.... - -Use the real email address for `root`. -Enter the ISP's outgoing mail relay in place of `mail.example.com`. -Some ISPs call this the "outgoing mail server" or "SMTP server". - -Make sure to disable Sendmail, including the outgoing mail service. -See <> for details. - -package:mail/ssmtp[] has some other options available. Refer to the examples in [.filename]#/usr/local/etc/ssmtp# or the manual page of ssmtp for more information. - -Setting up ssmtp in this manner allows any software on the computer that needs to send mail to function properly, while not violating the ISP's usage policy or allowing the computer to be hijacked for spamming. - -[[SMTP-dialup]] -== Using Mail with a Dialup Connection - -When using a static IP address, one should not need to adjust the default configuration. -Set the hostname to the assigned Internet name and Sendmail will do the rest. - -When using a dynamically assigned IP address and a dialup PPP connection to the Internet, one usually has a mailbox on the ISP's mail server. -In this example, the ISP's domain is `example.net`, the user name is `user`, the hostname is `bsd.home`, and the ISP has allowed `relay.example.net` as a mail relay. - -In order to retrieve mail from the ISP's mailbox, install a retrieval agent from the Ports Collection. package:mail/fetchmail[] is a good choice as it supports many different protocols. -Usually, the ISP will provide POP. -When using user PPP, email can be automatically fetched when an Internet connection is established with the following entry in [.filename]#/etc/ppp/ppp.linkup#: - -[.programlisting] -.... -MYADDR: -!bg su user -c fetchmail -.... - -When using Sendmail to deliver mail to non-local accounts, configure Sendmail to process the mail queue as soon as the Internet connection is established. -To do this, add this line after the above `fetchmail` entry in [.filename]#/etc/ppp/ppp.linkup#: - -[.programlisting] -.... - !bg su user -c "sendmail -q" -.... - -In this example, there is an account for `user` on `bsd.home`. -In the home directory of `user` on `bsd.home`, create a [.filename]#.fetchmailrc# which contains this line: - -[.programlisting] -.... -poll example.net protocol pop3 fetchall pass MySecret -.... - -This file should not be readable by anyone except `user` as it contains the password `MySecret`. - -In order to send mail with the correct `from:` header, configure Sendmail to use mailto:user@example.net[user@example.net] rather than mailto:user@bsd.home[user@bsd.home] and to send all mail via `relay.example.net`, allowing quicker mail transmission. - -The following [.filename]#.mc# should suffice: - -[.programlisting] -.... -VERSIONID(`bsd.home.mc version 1.0') -OSTYPE(bsd4.4)dnl -FEATURE(nouucp)dnl -MAILER(local)dnl -MAILER(smtp)dnl -Cwlocalhost -Cwbsd.home -MASQUERADE_AS(`example.net')dnl -FEATURE(allmasquerade)dnl -FEATURE(masquerade_envelope)dnl -FEATURE(nocanonify)dnl -FEATURE(nodns)dnl -define(`SMART_HOST', `relay.example.net') -Dmbsd.home -define(`confDOMAIN_NAME',`bsd.home')dnl -define(`confDELIVERY_MODE',`deferred')dnl -.... - -Refer to the previous section for details of how to convert this file into the [.filename]#sendmail.cf# format. -Do not forget to restart Sendmail after updating [.filename]#sendmail.cf#. - -[[SMTP-Auth]] -== SMTP Authentication +[[replace-dma]] +=== Replacing DragonFly Mail Agent (DMA) with Other MTA -Configuring SMTP authentication on the MTA provides a number of benefits. -SMTP authentication adds a layer of security to Sendmail, and provides mobile users who switch hosts the ability to use the same MTA without the need to reconfigure their mail client's settings each time. +As noted above, starting with FreeBSD version 14.0, the default MTA is DMA. +In this example, package:mail/postfix[] will be used as the alternative MTA. -[.procedure] -. Install package:security/cyrus-sasl2[] from the Ports Collection. This port supports a number of compile-time options. For the SMTP authentication method demonstrated in this example, make sure that `LOGIN` is not disabled. -. After installing package:security/cyrus-sasl2[], edit [.filename]#/usr/local/lib/sasl2/Sendmail.conf#, or create it if it does not exist, and add the following line: -+ -[.programlisting] -.... -pwcheck_method: saslauthd -.... +Before installing package:mail/postfix[] some extra configuration is needed. +Check [.filename]#/etc/periodic.conf# and make sure that these values are set to `NO`. +If this file does not exist, create it with these entries: -. Next, install package:security/cyrus-sasl2-saslauthd[] and add the following line to [.filename]#/etc/rc.conf#: -+ [.programlisting] .... -saslauthd_enable="YES" +daily_clean_hoststat_enable="NO" +daily_status_mail_rejects_enable="NO" +daily_status_include_submit_mailq="NO" +daily_submit_queuerun="NO" .... -+ -Finally, start the saslauthd daemon: -+ + +Then install package:mail/postfix[]: + [source,shell] .... -# service saslauthd start -.... -+ -This daemon serves as a broker for Sendmail to authenticate against the FreeBSD man:passwd[5] database. -This saves the trouble of creating a new set of usernames and passwords for each user that needs to use SMTP authentication, and keeps the login and mail password the same. -. Next, edit [.filename]#/etc/make.conf# and add the following lines: -+ -[.programlisting] -.... -SENDMAIL_CFLAGS=-I/usr/local/include/sasl -DSASL -SENDMAIL_LDADD=/usr/local/lib/libsasl2.so +# pkg install postfix .... -+ -These lines provide Sendmail the proper configuration options for linking to package:cyrus-sasl2[] at compile time. -Make sure that package:cyrus-sasl2[] has been installed before recompiling Sendmail. -. Recompile Sendmail by executing the following commands: -+ + +To start package:mail/postfix[] at system boot execute the following command: + [source,shell] .... -# cd /usr/src/lib/libsmutil -# make cleandir && make obj && make -# cd /usr/src/lib/libsm -# make cleandir && make obj && make -# cd /usr/src/usr.sbin/sendmail -# make cleandir && make obj && make && make install +# sysrc postfix_enable="YES" .... -+ -This compile should not have any problems if [.filename]#/usr/src# has not changed extensively and the shared libraries it needs are available. -. After Sendmail has been compiled and reinstalled, edit [.filename]#/etc/mail/freebsd.mc# or the local [.filename]#.mc#. Many administrators choose to use the output from man:hostname[1] as the name of [.filename]#.mc# for uniqueness. Add these lines: -+ -[.programlisting] + +Then execute the following commands to configure package:mail/postfix[]: + +[source,shell] .... -dnl set SASL options -TRUST_AUTH_MECH(`GSSAPI DIGEST-MD5 CRAM-MD5 LOGIN')dnl -define(`confAUTH_MECHANISMS', `GSSAPI DIGEST-MD5 CRAM-MD5 LOGIN')dnl +# mkdir -p /usr/local/etc/mail +# install -m 0644 /usr/local/share/postfix/mailer.conf.postfix /usr/local/etc/mail/mailer.conf .... -+ -These options configure the different methods available to Sendmail for authenticating users. -To use a method other than pwcheck, refer to the Sendmail documentation. -. Finally, run man:make[1] while in [.filename]#/etc/mail#. That will run the new [.filename]#.mc# and create a [.filename]#.cf# named either [.filename]#freebsd.cf# or the name used for the local [.filename]#.mc#. Then, run `make install restart`, which will copy the file to [.filename]#sendmail.cf#, and properly restart Sendmail. For more information about this process, refer to [.filename]#/etc/mail/Makefile#. - -To test the configuration, use a MUA to send a test message. -For further investigation, set the `LogLevel` of Sendmail to `13` and watch [.filename]#/var/log/maillog# for any errors. -For more information, refer to http://www.sendmail.org/~ca/email/auth.html[SMTP authentication]. +Once everything is configured, it is recommended to reboot the system. +Rebooting provides the opportunity to ensure that the system is correctly configured to start the new MTA automatically on boot. [[mail-agents]] == Mail User Agents @@ -793,45 +458,48 @@ These include graphical email clients such as Evolution or Balsa and console based clients such as mutt or alpine. [[mail-command]] -=== `mail` +=== mail -man:mail[1] is the default MUA installed with FreeBSD. It is a console based MUA that offers the basic functionality required to send and receive text-based email. +man:mail[1] is the default MUA installed with FreeBSD. +It is a console based MUA that offers the basic functionality required to send and receive text-based email. It provides limited attachment support and can only access local mailboxes. -Although `mail` does not natively support interaction with POP or IMAP servers, these mailboxes may be downloaded to a local [.filename]#mbox# using an application such as fetchmail. +Although man:mail[1] does not natively support interaction with POP or IMAP servers, these mailboxes may be downloaded to a local `mbox` using an application such as fetchmail or getmail. -In order to send and receive email, run `mail`: +In order to send and receive email, run man:mail[1]: [source,shell] .... % mail .... -The contents of the user's mailbox in [.filename]#/var/mail# are automatically read by `mail`. +The contents of the user's mailbox in [.filename]#/var/mail# are automatically read by man:mail[1]. Should the mailbox be empty, the utility exits with a message indicating that no mail could be found. If mail exists, the application interface starts, and a list of messages will be displayed. + Messages are automatically numbered, as can be seen in the following example: -[source,shell] +[.programlisting] .... Mail version 8.1 6/6/93. Type ? for help. -"/var/mail/marcs": 3 messages 3 new +"/var/mail/username": 3 messages 3 new >N 1 root@localhost Mon Mar 8 14:05 14/510 "test" N 2 root@localhost Mon Mar 8 14:05 14/509 "user account" N 3 root@localhost Mon Mar 8 14:05 14/509 "sample" .... Messages can now be read by typing kbd:[t] followed by the message number. + This example reads the first email: -[source,shell] +[.programlisting] .... & t 1 Message 1: From root@localhost Mon Mar 8 14:05:52 2004 -X-Original-To: marcs@localhost -Delivered-To: marcs@localhost -To: marcs@localhost +X-Original-To: username@localhost +Delivered-To: username@localhost +To: username@localhost Subject: test Date: Mon, 8 Mar 2004 14:05:52 +0200 (SAST) From: root@localhost (Charlie Root) @@ -840,15 +508,17 @@ .... As seen in this example, the message will be displayed with full headers. + To display the list of messages again, press kbd:[h]. -If the email requires a reply, press either kbd:[R] or kbd:[r] `mail` keys. -kbd:[R] instructs `mail` to reply only to the sender of the email, while kbd:[r] replies to all other recipients of the message. +If the email requires a reply, press either kbd:[R] or kbd:[r] man:mail[1] keys. +kbd:[R] instructs man:mail[1] to reply only to the sender of the email, while kbd:[r] replies to all other recipients of the message. These commands can be suffixed with the mail number of the message to reply to. After typing the response, the end of the message should be marked by a single kbd:[.] on its own line. + An example can be seen below: -[source,shell] +[.programlisting] .... & R 1 To: root@localhost @@ -864,7 +534,7 @@ The subject of the message may then be entered, followed by the message contents. The end of the message should be specified by putting a single kbd:[.] on its own line. -[source,shell] +[.programlisting] .... & mail root@localhost Subject: I mastered mail @@ -874,14 +544,13 @@ EOT .... -While using `mail`, press kbd:[?] to display help at any time. -Refer to man:mail[1] for more help on how to use `mail`. +While using man:mail[1], press kbd:[?] to display help at any time. +Refer to man:mail[1] for more help on how to use man:mail[1]. [NOTE] ==== man:mail[1] was not designed to handle attachments and thus deals with them poorly. Newer MUAs handle attachments in a more intelligent way. -Users who prefer to use `mail` may find the package:converters/mpack[] port to be of considerable use. ==== [[mutt-command]] @@ -895,7 +564,7 @@ * Maildir support. * Highly customizable. -Refer to http://www.mutt.org[http://www.mutt.org] for more information on mutt. +Refer to link:http://www.mutt.org[http://www.mutt.org] for more information on mutt. mutt may be installed using the package:mail/mutt[] port. After the port has been installed, mutt can be started by issuing the following command: @@ -924,7 +593,7 @@ ==== By default, mutt uses the man:vi[1] editor for creating and replying to emails. Each user can customize this by creating or editing the [.filename]#.muttrc# in their home directory and setting the `editor` variable or by setting the `EDITOR` environment variable. -Refer to http://www.mutt.org/[http://www.mutt.org/] for more information about configuring mutt. +Refer to link:http://www.mutt.org/[http://www.mutt.org/] for more information about configuring mutt. ==== To compose a new mail message, press kbd:[m]. @@ -994,126 +663,264 @@ image::pine5.png[alpine email client showing the message compose window] alpine can be customized using the [.guimenuitem]#SETUP# option from the main menu. -Consult http://www.washington.edu/alpine/[http://www.washington.edu/alpine/] for more information. -[[mail-fetchmail]] -== Using fetchmail +[[mail-advanced]] +== Advanced Topics + +This section covers more involved topics such as mail configuration and setting up mail for an entire domain. + +[[mail-config]] +=== Basic Configuration + +Out of the box, one can send email to external hosts as long as [.filename]#/etc/resolv.conf# is configured or the network has access to a configured DNS server. +To have email delivered to the MTA on the FreeBSD host, do one of the following: + +* Run a DNS server for the domain. +* Get mail delivered directly to the FQDN for the machine. + +In order to have mail delivered directly to a host, it must have a permanent static IP address, not a dynamic IP address. +If the system is behind a firewall, it must be configured to allow SMTP traffic. +To receive mail directly at a host, one of these two must be configured: -fetchmail is a full-featured IMAP and POP client. -It allows users to automatically download mail from remote IMAP and POP servers and save it into local mailboxes where it can be accessed more easily. -fetchmail can be installed using the package:mail/fetchmail[] port, and offers various features, including: +* Make sure that the lowest-numbered MX record in DNS points to the host's static IP address. +* Make sure there is no MX entry in the DNS for the host. -* Support for the POP3, APOP, KPOP, IMAP, ETRN and ODMR protocols. -* Ability to forward mail using SMTP, which allows filtering, forwarding, and aliasing to function normally. -* May be run in daemon mode to check periodically for new messages. -* Can retrieve multiple mailboxes and forward them, based on configuration, to different local users. +Either of the above will allow mail to be received directly at the host. -This section explains some of the basic features of fetchmail. -This utility requires a [.filename]#.fetchmailrc# configuration in the user's home directory in order to run correctly. -This file includes server information as well as login credentials. -Due to the sensitive nature of the contents of this file, it is advisable to make it readable only by the user, with the following command: +Try this: [source,shell] .... -% chmod 600 .fetchmailrc +# hostname .... -The following [.filename]#.fetchmailrc# serves as an example for downloading a single user mailbox using POP. -It tells fetchmail to connect to `example.com` using a username of `joesoap` and a password of `XXX`. -This example assumes that the user `joesoap` exists on the local system. +The output should be similar to the following: [.programlisting] .... -poll example.com protocol pop3 username "joesoap" password "XXX" +example.FreeBSD.org +.... + +[source,shell] +.... +# host example.FreeBSD.org .... -The next example connects to multiple POP and IMAP servers and redirects to different local usernames where applicable: +The output should be similar to the following: [.programlisting] .... -poll example.com proto pop3: -user "joesoap", with password "XXX", is "jsoap" here; -user "andrea", with password "XXXX"; -poll example2.net proto imap: -user "john", with password "XXXXX", is "myth" here; +example.FreeBSD.org has address 204.216.27.XX .... -fetchmail can be run in daemon mode by running it with `-d`, followed by the interval (in seconds) that fetchmail should poll servers listed in [.filename]#.fetchmailrc#. -The following example configures fetchmail to poll every 600 seconds: +In this example, mail sent directly to mailto:yourlogin@example.FreeBSD.org[yourlogin@example.FreeBSD.org] should work without problems, assuming man:dma[8] or man:sendmail[8] are running correctly on `example.FreeBSD.org`. + +For this example: [source,shell] .... -% fetchmail -d 600 +# host example.FreeBSD.org +.... + +The output should be similar to the following: + +[.programlisting] +.... +example.FreeBSD.org has address 204.216.27.XX +example.FreeBSD.org mail is handled (pri=10) by nevdull.FreeBSD.org +.... + +All mail sent to `example.FreeBSD.org` will be collected on `hub` under the same username instead of being sent directly to your host. + +The above information is handled by the DNS server. +The DNS record that carries mail routing information is the MX entry. +If no MX record exists, mail will be delivered directly to the host by way of its IP address. + +The MX entry for `freefall.FreeBSD.org` at one time looked like this: + +[.programlisting] +.... +freefall MX 30 mail.crl.net +freefall MX 40 agora.rdrop.com +freefall MX 10 freefall.FreeBSD.org +freefall MX 20 who.cdrom.com .... -More information on fetchmail can be found at http://www.fetchmail.info/[http://www.fetchmail.info/]. +`freefall` had many MX entries. +The lowest MX number is the host that receives mail directly, if available. +If it is not accessible for some reason, the next lower-numbered host will accept messages temporarily, and pass it along when a lower-numbered host becomes available. + +Alternate MX sites should have separate Internet connections in order to be most useful. +Your ISP can provide this service. + +[[mail-domain]] +=== Mail for a Domain + +When configuring an MTA for a network, any mail sent to hosts in its domain should be diverted to the MTA so that users can receive their mail on the master mail server. -[[mail-procmail]] -== Using procmail +To make life easiest, a user account with the same _username_ should exist on both the MTA and the system with the MUA. +Use man:adduser[8] to create the user accounts. -procmail is a powerful application used to filter incoming mail. -It allows users to define "rules" which can be matched to incoming mails to perform specific functions or to reroute mail to alternative mailboxes or email addresses. -procmail can be installed using the package:mail/procmail[] port. -Once installed, it can be directly integrated into most MTAs. -Consult the MTA documentation for more information. -Alternatively, procmail can be integrated by adding the following line to a [.filename]#.forward# in the home directory of the user: +The MTA must be the designated mail exchanger for each workstation on the network. +This is done in the DNS configuration with an MX record: [.programlisting] .... -"|exec /usr/local/bin/procmail || exit 75" +example.FreeBSD.org A 204.216.27.XX ; Workstation + MX 10 nevdull.FreeBSD.org ; Mailhost .... -The following section displays some basic procmail rules, as well as brief descriptions of what they do. -Rules must be inserted into a [.filename]#.procmailrc#, which must reside in the user's home directory. +This will redirect mail for the workstation to the MTA no matter where the A record points. +The mail is sent to the MX host. + +This must be configured on a DNS server. +If the network does not run its own DNS server, talk to the ISP or DNS provider. + +The following is an example of virtual email hosting. -The majority of these rules can be found in man:procmailex[5]. +Consider a customer with the domain `customer1.org`, where all the mail for `customer1.org` should be sent to `mail.myhost.com`. -To forward all mail from mailto:user@example.com[user@example.com] to an external address of mailto:goodmail@example2.com[goodmail@example2.com]: +The DNS entry should look like this: [.programlisting] .... -:0 -* ^From.*user@example.com -! goodmail@example2.com +customer1.org MX 10 mail.myhost.com +.... + +An `A` record is _not_ needed for `customer1.org` in order to only handle email for that domain. +However, running `ping` against `customer1.org` will not work unless an `A` record exists for it. + +Tell the MTA which domains and/or hostnames it should accept mail for. +Either of the following will work for Sendmail: + +* Add the hosts to [.filename]#/etc/mail/local-host-names# when using the `FEATURE(use_cw_file)`. +* Add a `Cwyour.host.com` line to [.filename]#/etc/sendmail.cf#. + +[[outgoing-only]] +=== Setting Up to Send Only + +There are many instances where one may only want to send mail through a relay. +Some examples are: + +* The computer is a desktop machine that needs to use programs such as man:mail[1], using the ISP's mail relay. +* The computer is a server that does not handle mail locally, but needs to pass off all mail to a relay for processing. + +While any MTA is capable of filling this particular niche, it can be difficult to properly configure a full-featured MTA just to handle offloading mail. +Programs such as Sendmail and Postfix are overkill for this use. + +Additionally, a typical Internet access service agreement may forbid one from running a "mail server". + +The easiest way to fulfill those needs is to install the package:mail/ssmtp[] port: + +[source,shell] +.... +# cd /usr/ports/mail/ssmtp +# make install replace clean .... -To forward all mails shorter than 1000 bytes to an external address of mailto:goodmail@example2.com[goodmail@example2.com]: +Once installed, package:mail/ssmtp[] can be configured with [.filename]#/usr/local/etc/ssmtp/ssmtp.conf#: [.programlisting] .... -:0 -* < 1000 -! goodmail@example2.com +root=yourrealemail@example.com +mailhub=mail.example.com +rewriteDomain=example.com +hostname=_HOSTNAME_ .... -To send all mail sent to mailto:alternate@example.com[alternate@example.com] to a mailbox called [.filename]#alternate#: +Use the real email address for `root`. +Enter the ISP's outgoing mail relay in place of `mail.example.com`. +Some ISPs call this the "outgoing mail server" or "SMTP server". + +Make sure to disable Sendmail, including the outgoing mail service. +See <> for details. + +package:mail/ssmtp[] has some other options available. Refer to the examples in [.filename]#/usr/local/etc/ssmtp# or the manual page of ssmtp for more information. + +Setting up ssmtp in this manner allows any software on the computer that needs to send mail to function properly, while not violating the ISP's usage policy or allowing the computer to be hijacked for spamming. + +[[SMTP-Auth]] +=== SMTP Authentication in Sendmail + +Configuring SMTP authentication on the MTA provides a number of benefits. +SMTP authentication adds a layer of security to Sendmail, and provides mobile users who switch hosts the ability to use the same MTA without the need to reconfigure their mail client's settings each time. + +Install package:security/cyrus-sasl2[] from the Ports Collection. +This port supports a number of compile-time options. +For the SMTP authentication method demonstrated in this example, make sure that `LOGIN` is not disabled. + +After installing package:security/cyrus-sasl2[], edit [.filename]#/usr/local/lib/sasl2/Sendmail.conf#, or create it if it does not exist, and add the following line: [.programlisting] .... -:0 -* ^TOalternate@example.com -alternate +pwcheck_method: saslauthd +.... + +Next, install package:security/cyrus-sasl2-saslauthd[] and add execute the following command: + +[source,shell] +.... +# sysrc saslauthd_enable="YES" +.... + +Finally, start the saslauthd daemon: + +[source,shell] +.... +# service saslauthd start .... -To send all mail with a subject of "Spam" to [.filename]#/dev/null#: +This daemon serves as a broker for Sendmail to authenticate against the FreeBSD man:passwd[5] database. +This saves the trouble of creating a new set of usernames and passwords for each user that needs to use SMTP authentication, and keeps the login and mail password the same. + +Next, edit [.filename]#/etc/make.conf# and add the following lines: [.programlisting] .... -:0 -^Subject:.*Spam -/dev/null +SENDMAIL_CFLAGS=-I/usr/local/include/sasl -DSASL +SENDMAIL_LDADD=/usr/local/lib/libsasl2.so +.... + +These lines provide Sendmail the proper configuration options for linking to package:cyrus-sasl2[] at compile time. +Make sure that package:cyrus-sasl2[] has been installed before recompiling Sendmail. + +Recompile Sendmail by executing the following commands: + +[source,shell] +.... +# cd /usr/src/lib/libsmutil +# make cleandir && make obj && make +# cd /usr/src/lib/libsm +# make cleandir && make obj && make +# cd /usr/src/usr.sbin/sendmail +# make cleandir && make obj && make && make install .... -A useful recipe that parses incoming `FreeBSD.org` mailing lists and places each list in its own mailbox: +This compile should not have any problems if [.filename]#/usr/src# has not changed extensively and the shared libraries it needs are available. + +After Sendmail has been compiled and reinstalled, edit [.filename]#/etc/mail/freebsd.mc# or the local [.filename]#.mc#. +Many administrators choose to use the output from man:hostname[1] as the name of [.filename]#.mc# for uniqueness. + +Add these lines: [.programlisting] .... -:0 -* ^Sender:.owner-freebsd-\/[^@]+@FreeBSD.ORG -{ - LISTNAME=${MATCH} - :0 - * LISTNAME??^\/[^@]+ - FreeBSD-${MATCH} -} +dnl set SASL options +TRUST_AUTH_MECH(`GSSAPI DIGEST-MD5 CRAM-MD5 LOGIN')dnl +define(`confAUTH_MECHANISMS', `GSSAPI DIGEST-MD5 CRAM-MD5 LOGIN')dnl .... + +These options configure the different methods available to Sendmail for authenticating users. +To use a method other than pwcheck, refer to the Sendmail documentation. + +Finally, run man:make[1] while in [.filename]#/etc/mail#. +That will run the new [.filename]#.mc# and create a [.filename]#.cf# named either [.filename]#freebsd.cf# or the name used for the local [.filename]#.mc#. + +Then, run `make install restart`, which will copy the file to [.filename]#sendmail.cf#, and properly restart Sendmail. + +For more information about this process, refer to [.filename]#/etc/mail/Makefile#. + +To test the configuration, use a MUA to send a test message. +For further investigation, set the `LogLevel` of Sendmail to `13` and watch [.filename]#/var/log/maillog# for any errors. + +For more information, refer to http://www.sendmail.org/~ca/email/auth.html[SMTP authentication].