Sendmail Setup for Your Home Network

by Jhon H. O.

Sendmail is an extraordinary piece of software, adaptable for complex to modest installations with different needs. Almost every UNIX administrator has faced the installation and configuration procedures of Sendmail and learned that the available options are extensive and, sometimes, frustrating.

In this article we will address a basic installation procedure (sort of a recipe for a quick set up of your mail server) for the average user. Assuming the system is a home or small company network with a Linux machine running Sendmail as the mail server, Sendmail's functions will be to receive mail messages from machines on the internal network, deliver local messages to their respective users and deliver to the Internet messages for external destinations. Additionally, the server will receive mail from the Internet.

I assume an internal network domain with the name, and the machines in this network use non-public IP numbers of the form 192.168.XXX.XXX. The mail server has an interface connected to the Internet with a real IP number needed for external mail reception using the domain

In my experience I have found having different domains for internal and external networks makes it easier to have other types of setups, like DNS (domain name services), separate traffic and privacy.

Obtaining and Installing Sendmail

Every Linux distribution includes Sendmail as one of the basic programs and some default configuration files that work well. However, if you are concerned about security or you are a do-it-yourself person, it is advisable to install the latest version of Sendmail. The procedure is straightforward, and you can use an updated RPM or download the source code from (I prefer the last method). Next, extract the sources and compile the program using the predefined scripts.

The following is a listing of the commands I used to unzip the tar file and build the code on my machine, which runs a Red Hat Linux 6.2 distribution.

$ tar -zxvf sendmail.8.11.2.tar.gz
$ cd sendmail-8.11.2
$ ./Build
$ su
# ./Build install
Creating a Customized Configuration File

Now you must set up the configuration files. If you have compiled the source version without modifications, all the required files will live in /etc/mail/. The most important file is /etc/mail/; this file holds the options necessary for Sendmail to work and is a text file. In the old days, you would have had to edit this by hand to change the configuration, and if you look at the text, it is somewhat confusing.

Fortunately newer versions of Sendmail come with an easier setup procedure based on predefined blocks and macros that hide the details of the configuration--think of it as compiling a configuration file for Sendmail.

The following commands can be used to generate a valid Sendmail configuration file from the cf/cf subdirectory of the source directory.

$ cd sendmail-8.11.2
$ cd cf/cf
$ cp
$ m4 ../m4/cf.m4 >

The resulting file can be installed in /etc/mail and used to run the Sendmail server. You must restart the service to activate the new options. For Red Hat, this can be done with a command like:

# /etc/rc.d/init/sendmail restart

Creating a Configuration File for a Mail Server

Now that you have generated a standard setup file for Sendmail, the next step is to build a file for the main mail server, the one that manages e-mail both internal and external on your network.

Listing 1 shows the complete source file for the configuration. I will now cover each of the features in more detail.

Listing 1. Source File for Sendmail Configuration

The combination of the allmasquerade, masquerade_envelope and MASQUERADE_AS features and directives are used to hide the names of the hosts in your internal network and make the mail messages appear to come from This way you have a more uniform address across your organization, regardless of the internal machine used to send the e-mail.

The other section added to this file rewrites the recipient's address. This kind of rewrite generally occurs when an internal machine or a local program is used to send e-mail (pine on the mail server, for example). In that case the recipient address may contain the server name and intranet domain. What this rewrites does is catch this type of recipient address and rewrite it to a uniform address.

Creating a Configuration File for a Linux Client Machine

For the internal Linux machines on our network, we can create a configuration file because the client machines use the mail server (mailhub) to send the e-mail. In this form, all of the rewrites and masquerading rules already discussed before are applied to the mail sent from these machines. The contents of the file are:

FEATURE(nullclient, mailhub)dnl

The magic comes from the last line of this file. FEATURE(nullcient, mailhub) indicates we are using "mailhub" as our mail server. The Sendmail process on the client machines simply sent the e-mail to this server.

The procedure for generating the final file is the same as specified in the previous section.


Although alternative programs to Sendmail (Postfix, qmail, etc.) exist, for now Sendmail continues to be the most widely used mail transport agent.

I hope this article helps you to set up your mail server, but like most things on Linux this is not the only approach to this particular problem. I've showed you only what I have done.

Another important thing to remember is that although the setup shown in this article makes the quick setup of a mail server easier, you should complement this with good security measures to keep undesirable visitors away from your network.

Jhon H. Caicedo O. works in the R&D Area of O.S.S.O (Observatorio Sismológico del SurOccidente) located at Cali-Colombia, has been a Linux user and system administrator since 1994, currently he plays with Real time applications of Linux, Data Acquisition Systems and Embedded Linux. You can reach him at or at the OSSO home page.

Load Disqus comments